Intl.NumberFormat.supportedLocalesOf()

Сводка

Метод Intl.NumberFormat.supportedLocalesOf() возвращает массив, содержащий те из предоставленных локалей, что поддерживаются при форматировании чисел без отката к локали по умолчанию среды выполнения.

Синтаксис

Intl.NumberFormat.supportedLocalesOf(locales[, options])

Параметры

locales
Строка с языковой меткой BCP 47, либо массив таких строк. Описание общей формы и интерпретации аргумента locales смотрите на странице, посвящённой объекту Intl.
options

Необязательный параметр. Объект, который может содержать следующее свойство:

localeMatcher
Используемый алгоритм сопоставления локалей. Возможными значениями являются "lookup" и "best fit"; значением по умолчанию является "best fit". Информацию по этой опции смотрите на странице, посвящённой объекту Intl.

Описание

Возвращает массив с подмножеством языковых меток, предоставленных в аргументе locales. Возвращаются те языковые метки, для которых среда выполнения поддерживает форматирование чисел без отката к локали по умолчанию; при поиске используется предоставленный алгоритм сопоставления локалей.

Примеры

Пример: использование supportedLocalesOf

Предполагая, что среда выполнения поддерживает индонезийское и немецкое, но на балийское форматирование чисел, метод supportedLocalesOf вернёт неизменными индонезийскую и немецкую языковые метки, даже несмотря на то, что сортировка pinyin не относится к форматированию чисел, не используется с индонезийским языком и вряд ли будет поддерживаться в немецком языке для Индонезии. Обратите внимание на используемую здесь спецификацию алгоритма "lookup" — сопоставление "best fit" может решить, что индонезийский язык является адекватным сопоставлением с балийским, поскольку большинство людей, говорящих на балийском, также понимают индонезийский, и поэтому может возвратиться ещё и языковая метка балийского языка.

var locales = ['ban', 'id-u-co-pinyin', 'de-ID'];
var options = { localeMatcher: 'lookup' };
console.log(Intl.NumberFormat.supportedLocalesOf(locales, options).join(', '));
// → "id-u-co-pinyin, de-ID"

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

Спецификация Статус Комментарии
ECMAScript Internationalization API 1.0 (ECMA-402)
Определение 'Intl.NumberFormat.supportedLocalesOf' в этой спецификации.
Стандарт Изначальное определение.

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

BCD tables only load in the browser

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