Обзор

Метод getLocaleName получает отображаемое название локали с помощью API Intl.DisplayNames. Он возвращает человекочитаемое название для любого допустимого кода локали BCP‑47, локализованное в соответствии с исходной локалью экземпляра.

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

const name = gt.getLocaleName('fr-CA');
console.log(name); // "французский (Канада)"

Справка

Параметры

Описание параметров

Возвращает

string — локализованное отображаемое имя локали.

Исключения

• Error — если локаль не указана и у экземпляра не настроен targetLocale

Поведение

Язык отображения

Отображаемое имя локализуется в соответствии со следующим порядком:

1. sourceLocale экземпляра (если задано)
2. Локаль по умолчанию библиотеки («en»)

Интеграция пользовательских сопоставлений

• В первую очередь проверяются пользовательские сопоставления локалей
• Если задано пользовательское имя, оно имеет приоритет
• В остальных случаях используется Intl.DisplayNames для стандартных кодов BCP‑47

Примеры

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

// Получить название целевой локали
console.log(gt.getLocaleName()); // "French (France)"

// Получить названия для других локалей
console.log(gt.getLocaleName('es')); // "Spanish (Spain)"
console.log(gt.getLocaleName('de')); // "German (Germany)"
console.log(gt.getLocaleName('ja')); // "Japanese (Japan)"

Примечания

• Метод использует sourceLocale экземпляра, чтобы определить язык отображения
• Пользовательские сопоставления имен имеют приоритет над стандартными Intl.DisplayNames

Следующие шаги

• Получите эмодзи локали с помощью getLocaleEmoji
• Получите подробные сведения о локали с помощью getLocaleProperties
• Узнайте о типе CustomMapping