Intl.RelativeTimeFormat.supportedLocalesOf()

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

Попробуйте

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

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

Синтаксис

Intl.RelativeTimeFormat.supportedLocalesOf(locales)
Intl.RelativeTimeFormat.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.RelativeTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

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

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

См. также

• Intl.RelativeTimeFormat