Descripción general

El método standardizeLocale normaliza un código de configuración regional BCP-47 para asegurar el formato y la capitalización correctos. Convierte los códigos de configuración regional a su formato canónico, haciéndolos adecuados para su uso con APIs de internacionalización y garantizando la coherencia en toda tu aplicación.

Referencia

Parámetros

Descripción de los parámetros

Devuelve

string - El código de configuración regional BCP-47 estandarizado, o una cadena vacía si la entrada no es válida

Excepciones

• Error - Si no se proporciona ninguna locale y la instancia no tiene targetLocale configurado

Comportamiento

Correcciones comunes de formato aplicadas:

• en_US → en-US (guion bajo por guion)
• zh_cn → zh-CN (guion bajo por guion, uso de mayúsculas/minúsculas)
• EN-gb → en-GB (idioma en minúsculas, región en mayúsculas)
• Fr-ca → fr-CA (uso de mayúsculas/minúsculas correcto en todo)
• ja_jp → ja-JP (guion bajo y uso de mayúsculas/minúsculas)

Ejemplos

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es-ES'
});

// Estandarizar varios formatos de locale
console.log(gt.standardizeLocale('en_us')); // "en-US"
console.log(gt.standardizeLocale('zh_cn')); // "zh-CN"
console.log(gt.standardizeLocale('EN-gb')); // "en-GB"
console.log(gt.standardizeLocale('fr-ca')); // "fr-CA"

// Los locales ya estandarizados se mantienen sin cambios
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"

Notas

• Convierte guiones bajos en guiones y normaliza el uso de mayúsculas y minúsculas
• Devuelve una cadena vacía para códigos de configuración regional no válidos
• Los códigos de idioma se ponen en minúsculas y los de región en mayúsculas
• Conserva las extensiones y variantes del locale cuando existen

Próximos pasos

• Valida los locales estandarizados con isValidLocale
• Resuelve los locales canónicos con resolveCanonicalLocale
• Obtén las propiedades del locale con getLocaleProperties