Descripción general

El método getLocaleName obtiene el nombre visible de un código de configuración regional mediante la API Intl.DisplayNames. Devuelve un nombre legible para cualquier código de configuración regional BCP-47 válido, localizado según el locale de origen de la instancia.

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

const name = gt.getLocaleName('fr-CA');
console.log(name); // "Francés (Canadá)"

Referencias

Parámetros

Descripción de los parámetros

Devuelve

string - El nombre de visualización localizado del locale.

Lanza

• Error - Si no se proporciona ningún locale y la instancia no tiene targetLocale configurado

Comportamiento

Idioma de visualización

El nombre para mostrar se localiza según:

1. El sourceLocale de la instancia (si está configurado)
2. El locale predeterminado de la biblioteca ('en')

Integración de asignación personalizada

• Primero se comprueban las asignaciones de locale personalizadas
• Si se define un name personalizado, tiene prioridad
• Recurre a Intl.DisplayNames para los códigos BCP-47 estándar

Ejemplos

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

// Obtener nombre para el locale de destino
console.log(gt.getLocaleName()); // "French (France)"

// Obtener nombres para otros locales
console.log(gt.getLocaleName('es')); // "Spanish (Spain)"
console.log(gt.getLocaleName('de')); // "German (Germany)"
console.log(gt.getLocaleName('ja')); // "Japanese (Japan)"

Notas

• El método utiliza el sourceLocale de la instancia para determinar el idioma de visualización
• Los nombres de mapeo personalizados tienen prioridad sobre los Intl.DisplayNames estándar

Próximos pasos

• Obtén el emoji del locale con getLocaleEmoji
• Obtén información completa del locale con getLocaleProperties
• Conoce el tipo CustomMapping