Überblick

Die Methode getLocaleName ruft den Anzeigenamen eines locale code mithilfe der Intl.DisplayNames‑API ab. Sie gibt einen lesbaren Namen für jeden gültigen BCP‑47‑locale code zurück, lokalisiert gemäß der Quell-locale der Instanz.

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

const name = gt.getLocaleName('fr-CA');
console.log(name); // „Französisch (Kanada)"

Referenzen

Parameter

Parameterbeschreibung

Rückgabe

string - Der lokalisierte Anzeigename der Locale.

Wirft

• Error – Wenn keine locale angegeben ist und die Instanz kein targetLocale konfiguriert hat

Verhalten

Anzeigesprache

Der Anzeigename wird lokalisiert anhand von:

1. sourceLocale der Instanz (falls konfiguriert)
2. Standardlocale der Bibliothek ('en')

Integration benutzerdefinierter Zuordnungen

• Benutzerdefinierte Locale-Zuordnungen werden zuerst geprüft
• Wenn ein benutzerdefinierter Name definiert ist, hat dieser Vorrang
• Für Standard-BCP‑47-Codes wird auf Intl.DisplayNames zurückgegriffen

Beispiele

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

// Name für Ziel-Locale abrufen
console.log(gt.getLocaleName()); // "Französisch (Frankreich)"

// Namen für andere Locales abrufen
console.log(gt.getLocaleName('es')); // "Spanisch (Spanien)"
console.log(gt.getLocaleName('de')); // "Deutsch (Deutschland)"
console.log(gt.getLocaleName('ja')); // "Japanisch (Japan)"

Hinweise

• Die Methode verwendet die sourceLocale der Instanz, um die Anzeigesprache zu ermitteln
• Benutzerdefinierte Mapping-Namen haben Vorrang vor den Standard-Intl.DisplayNames

Nächste Schritte

• Holen Sie sich das Locale-Emoji mit getLocaleEmoji
• Rufen Sie umfassende Locale-Informationen mit getLocaleProperties ab
• Erfahren Sie mehr über den Typ CustomMapping](/docs/core/types/custom-mapping)