Présentation

La méthode getLocaleName récupère le nom d’affichage d’un code de locale à l’aide de l’API Intl.DisplayNames. Elle renvoie un nom lisible pour tout code de locale BCP-47 valide, localisé selon la locale source de l’instance.

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

const name = gt.getLocaleName('fr-CA');
console.log(name); // "Français (Canada)"

Références

Paramètres

Description des paramètres

Renvoie

string - Le nom d’affichage localisé de la locale.

Exceptions

• Error - Si aucune locale n’est fournie et qu’aucun targetLocale n’est configuré pour l’instance

Comportement

Langue d’affichage

Le nom d’affichage est localisé selon :

1. Le sourceLocale de l’instance (si configuré)
2. La locale par défaut de la bibliothèque (« en »)

Intégration de mappage personnalisé

• Les mappages de locales personnalisés sont vérifiés en premier
• Si un nom personnalisé est défini, il est prioritaire
• Utilise Intl.DisplayNames par défaut pour les codes BCP‑47 standard

Exemples

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

// Obtenir le nom de la locale cible
console.log(gt.getLocaleName()); // "French (France)"

// Obtenir les noms d'autres locales
console.log(gt.getLocaleName('es')); // "Spanish (Spain)"
console.log(gt.getLocaleName('de')); // "German (Germany)"
console.log(gt.getLocaleName('ja')); // "Japanese (Japan)"

Notes

• La méthode utilise le sourceLocale de l’instance pour déterminer la langue d’affichage
• Les noms de correspondance personnalisés ont priorité sur les Intl.DisplayNames standard

Prochaines étapes

• Récupérez l’emoji du locale avec getLocaleEmoji
• Récupérez des informations complètes sur le locale avec getLocaleProperties
• En savoir plus sur le type CustomMapping](/docs/core/types/custom-mapping)