Übersicht

Die Methode getLocaleName ruft den Anzeigenamen eines locale code mithilfe der Intl.DisplayNames-API ab. Sie gibt einen menschenlesbaren Namen für jeden gültigen BCP-47 locale code zurück, lokalisiert entsprechend der source locale der Instanz.

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

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

Referenz

Parameter

Parameterbeschreibung

Rückgabewert

string – Der lokalisierte Anzeigename der locale.

Wirft

• Error – wenn kein locale übergeben wird und für die Instanz kein targetLocale konfiguriert ist

Verhalten

Anzeigesprache

Der Anzeigename wird wie folgt lokalisiert:

1. sourceLocale der Instanz (falls konfiguriert)
2. Standard-locale der Bibliothek („en“)

Benutzerdefinierte Mapping-Integration

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

Beispiele

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

// Namen für das 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 das sourceLocale der Instanz, um die Anzeigesprache zu bestimmen
• Benutzerdefinierte Mapping-Namen haben Vorrang vor den Standard-Intl.DisplayNames

Nächste Schritte

• Hol dir das locale-emoji mit getLocaleEmoji
• Erhalte umfassende locale-Informationen mit getLocaleProperties
• Erfahre mehr über den CustomMapping-Typ](/docs/core/types/custom-mapping)