Intl.DateTimeFormat.supportedLocalesOf()

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

Попробуйте

const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };

console.log(Intl.DateTimeFormat.supportedLocalesOf(locales, options));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)

Синтаксис

Intl.DateTimeFormat.supportedLocalesOf(locales)
Intl.DateTimeFormat.supportedLocalesOf(locales, options)

Параметры

locales

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

options Необязательный

Объект, который может иметь следующее свойство:

localeMatcher

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

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

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

Примеры

Использование supportedLocalesOf()

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

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

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

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

См. также

• Intl.DateTimeFormat