Intl.getCanonicalLocales()

Статический метод Intl.getCanonicalLocales() возвращает массив, содержащий канонические имена локалей. Дубликаты будут опущены, а элементы будут проверены как структурно действительные языковые теги.

Попробовать

console.log(Intl.getCanonicalLocales("EN-US"));
// Expected output: Array ["en-US"]

console.log(Intl.getCanonicalLocales(["EN-US", "Fr"]));
// Expected output: Array ["en-US", "fr"]

try {
  Intl.getCanonicalLocales("EN_US");
} catch (err) {
  console.log(err.toString());
  // Expected output: RangeError: invalid language tag: "EN_US"
}

Синтаксис

Intl.getCanonicalLocales(locales)

Параметры

locales

Список значений String, для которых необходимо получить канонические имена локалей.

Возвращаемое значение

Массив, содержащий канонические имена локалей.

Примеры

Использование getCanonicalLocales

Intl.getCanonicalLocales("EN-US"); // ["en-US"]
Intl.getCanonicalLocales(["EN-US", "Fr"]); // ["en-US", "fr"]

Intl.getCanonicalLocales("EN_US");
// RangeError: invalid language tag: "EN_US"

Спецификации

Совместимость с браузерами

Смотрите также

• Полифил Intl.getCanonicalLocales в FormatJS
• Intl.NumberFormat.supportedLocalesOf()
• Intl.DateTimeFormat.supportedLocalesOf()
• Intl.Collator.supportedLocalesOf()