GT ClassMethodsLocales

resolveAliasLocale

Справка по API: метод GT resolveAliasLocale

Обзор

Метод resolveAliasLocale возвращает исходный код локали‑псевдонима по каноническому коду локали, когда настроено пользовательское сопоставление. Это обратная операция к resolveCanonicalLocale.


Справочные материалы

Параметры

Prop

Type

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

ПараметрОписание
localeКанонический код локали, используемый для обратного отображения на её псевдоним
customMappingНеобязательное пользовательское отображение, используемое вместо отображения экземпляра

Возвращает

string — код локали-алиаса, если есть соответствующее отображение; иначе исходный код локали

Исключения

  • Error — если локаль не передана и целевая локаль не настроена

Примеры

const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    'cn': { code: 'zh', name: 'Mandarin' },
  }
});

// Преобразует канонический язык/локаль обратно в псевдоним
const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"

// Для не сопоставленного языка/локали возвращается исходное значение
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"

Примечания

  • Возвращает исходный код локали-алиаса, если задано пользовательское сопоставление
  • Возвращает переданную локаль без изменений, если сопоставление не найдено

Дальнейшие шаги

  • Определяйте канонические локали с помощью resolveCanonicalLocale
  • Проверяйте валидность локалей с помощью isValidLocale
  • Получайте свойства локали с помощью getLocaleProperties

Насколько полезно это руководство?

resolveAliasLocale