Descripción general

El método standardizeLocale estandariza un código BCP-47 de configuración regional para garantizar el formato y el uso de mayúsculas/minúsculas correctos. Convierte los códigos de configuración regional a su formato canónico adecuado, lo que los hace aptos para su uso con APIs de internacionalización y garantiza la coherencia en toda tu aplicación.

Referencias

Parámetros

Descripción de 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 locale y la instancia no tiene un targetLocale configurado

Comportamiento

Correcciones de formato comunes aplicadas:

• en_US → en-US (guion bajo a guion)
• zh_cn → zh-CN (guion bajo a guion, mayúsculas/minúsculas)
• EN-gb → en-GB (idioma en minúsculas, región en mayúsculas)
• Fr-ca → fr-CA (uso correcto de mayúsculas/minúsculas)
• ja_jp → ja-JP (guion bajo y 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 convierten a minúsculas y los códigos de región a mayúsculas
• Conserva las extensiones y variantes del locale cuando están presentes

Próximos pasos

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