Descripción general

El método getLocaleProperties obtiene propiedades completas para un código de configuración regional, proporcionando información detallada como nombres de visualización, códigos de región, información de escritura y emojis de bandera. Devuelve un objeto LocaleProperties con todos los datos necesarios para crear interfaces de usuario internacionalizadas avanzadas.

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

const props = gt.getLocaleProperties('fr-CA');
console.log(props.name); // "francés (Canadá)"
console.log(props.nativeName); // "français (Canada)"
console.log(props.emoji); // "🇨🇦"

Referencias

Parámetros

Descripción de parámetros

Devuelve

LocaleProperties - Un objeto integral que contiene toda la información del locale:

• code: Código de configuración regional estandarizado
• name: Nombre visible en el locale de origen
• nativeName: Nombre visible en el propio locale
• languageCode, languageName, nativeLanguageName: Información del idioma
• regionCode, regionName, nativeRegionName: Información de la región
• scriptCode, scriptName, nativeScriptName: Información del sistema de escritura
• maximizedCode, minimizedCode: Formas canónicas
• nameWithRegionCode, nativeNameWithRegionCode: Formatos de visualización combinados
• emoji: Bandera o emoji representativo

Lanza

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

Ejemplos

Uso básico

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

// Obtener propiedades para el locale de destino
const props = gt.getLocaleProperties();
console.log(props.name); // "French (France)"
console.log(props.nativeName); // "français (France)"
console.log(props.languageCode); // "fr"
console.log(props.regionCode); // "FR"
console.log(props.emoji); // "🇫🇷"

// Obtener propiedades para otros locales
const germanProps = gt.getLocaleProperties('de-AT');
console.log(germanProps.name); // "Austrian German"
console.log(germanProps.nativeName); // "Österreichisches Deutsch"
console.log(germanProps.regionName); // "Austria"
console.log(germanProps.nativeRegionName); // "Österreich"

Notas

• Todos los nombres para mostrar respetan la configuración sourceLocale de la instancia
• Las propiedades de asignación personalizadas tienen prioridad sobre las APIs de Intl estándar

Próximos pasos

• Explora la interfaz LocaleProperties
• Obtén nombres de locales simples con getLocaleName
• Obtén el emoji del locale con getLocaleEmoji
• Conoce el tipo CustomMapping