Intl.supportedValuesOf()

Статический метод Intl.supportedValuesOf() возвращает массив, содержащий поддерживаемые реализацией значения календаря, сортировки, валюты, систем счисления или единиц измерения.

Дубликаты опускаются, а массив сортируется в лексикографическом порядке по возрастанию (или, точнее, с использованием Array.prototype.sort() с функцией сравнения undefined).

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

Этот метод не зависит от локали: некоторые идентификаторы могут поддерживаться или предпочитаться только в определенных локалях. Если вы хотите определить предпочтительные значения для конкретной локали, следует использовать объект Intl.Locale, такой как Intl.Locale.prototype.getCalendars().

Попробуйте

console.log(Intl.supportedValuesOf("calendar"));
console.log(Intl.supportedValuesOf("collation"));
console.log(Intl.supportedValuesOf("currency"));
console.log(Intl.supportedValuesOf("numberingSystem"));
console.log(Intl.supportedValuesOf("timeZone"));
console.log(Intl.supportedValuesOf("unit"));
// Expected output: Array ['key'] (for each key)

try {
  Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
  console.log(err.toString());
  // Expected output: RangeError: invalid key: "someInvalidKey"
}

Синтаксис

Intl.supportedValuesOf(key)

Параметры

key

Строка ключа, указывающая категорию возвращаемых значений. Это одно из следующих значений:

• "calendar": см. поддерживаемые типы календарей
• "collation": см. поддерживаемые типы сортировки
• "currency": см. поддерживаемые идентификаторы валют
• "numberingSystem": см. поддерживаемые типы систем счисления
• "timeZone": см. поддерживаемые идентификаторы часовых поясов
• "unit": см. поддерживаемые идентификаторы единиц измерения

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

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

Поддерживаемые типы календарей

Ниже приведены все значения, которые обычно поддерживаются браузерами для ключа calendar. Эти значения могут использоваться для опции calendar или ключевого расширения Unicode ca при создании таких объектов, как Intl.DateTimeFormat, а также для создания Temporal объектов даты. Этот список явно санкционирован спецификацией ECMA-402, поэтому все реализации должны быть согласованы.

По состоянию на октябрь 2025 года в календаре japanese даты до 1868-10-23 по ISO (дата начала 1 года Мэйдзи) работают в браузерах некорректно двумя способами. Во-первых, CLDR имел неверную дату начала эры Мэйдзи, что приводит к тому, что реализации календаря продлевают эру Мэйдзи дальше в прошлое, чем это было на самом деле. Во-вторых, предстоящее Предложение по эре и коду месяца Intl предусматривает, что даты до 1873-01-01 по ISO должны использовать григорианские эры, но браузеры традиционно использовали аппроксимации предыдущих японских эр. Календарь japanese был введен 1 января 6 года Мэйдзи / 1873-01-01 по ISO, поэтому эти проблемы затрагивают только пролептические даты.

Типы ниже указаны в CLDR, но не имеют в браузерах реализаций, отличных от вышеуказанных календарей.

Документация по Temporal.PlainDate.prototype.era и Temporal.PlainDate.prototype.monthCode содержит дополнительную информацию о различных календарях.

Ссылки:

• Ключи типов календарей CLDR
• UTS 35, Даты
• Типы исламских календарей (предложение по дизайну CLDR)

Поддерживаемые типы сортировки

Ниже приведены все значения, которые обычно поддерживаются браузерами для ключа collation. Эти значения могут использоваться для опции collation или ключа расширения Unicode co при создании таких объектов, как Intl.Collator.

Типы ниже указаны в данных CLDR, но устарели, их использование не рекомендуется и/или они могут не быть обозначены браузерами как поддерживаемые по различным причинам. Избегайте их использования:

Ссылки:

• Ключи типов сортировки CLDR
• UTS 35, Сортировка

Поддерживаемые идентификаторы валют

Идентификаторы валют — это трехбуквенные заглавные коды, определенные в ISO 4217. Эти значения могут использоваться для опции currency при создании таких объектов, как Intl.NumberFormat, а также для Intl.DisplayNames.prototype.of(). Существует более 300 широко используемых идентификаторов, поэтому мы не будем их перечислять. Исчерпывающий список возможных идентификаторов см. в статье в Википедии.

Ссылки:

• Ключи типов валют CLDR
• Коды валют ISO 4217
• UTS 35, Валюты

Поддерживаемые типы систем счисления

Ниже приведены все значения, которые обычно поддерживаются браузерами для ключа numberingSystem. Эти значения могут использоваться для опции numberingSystem или ключа расширения Unicode nu при создании таких объектов, как Intl.NumberFormat. Для строк с "символами цифр" среда выполнения переводит цифры по одной без дополнительных действий. Другие, помеченные как "алгоритмические", требуют дополнительных алгоритмов для перевода цифр. Чем выше кодовая точка Unicode, тем новее система счисления и тем вероятнее, что она не будет поддерживаться всеми браузерами.

Существует три специальных значения: native, traditio и finance, значения которых зависят от локали и будут разрешены в правильную систему в зависимости от локали. Следовательно, методы resolvedOptions() никогда не будут возвращать эти значения, но Intl.Locale.prototype.numberingSystem будет (если они предоставлены в качестве входных данных).

Ссылки:

• Ключи типов систем счисления CLDR
• Определения систем счисления CLDR
• UTS 35, Системы счисления

Поддерживаемые идентификаторы часовых поясов

Поддерживаемые идентификаторы часовых поясов могут использоваться для опции timeZone при создании таких объектов, как Intl.DateTimeFormat, а также для создания Temporal объектов даты. Существует более 400 широко используемых идентификаторов, поэтому мы не будем их перечислять. Исчерпывающий список возможных идентификаторов см. в статье в Википедии или в базе данных часовых поясов IANA.

При просмотре списка обратите внимание, что стандартизация Temporal требует, чтобы браузеры всегда возвращали основной идентификатор из базы данных IANA, который может меняться со временем. Подробнее см. часовые пояса и смещения. Например, возвращаемый массив должен содержать "Asia/Kolkata" вместо "Asia/Calcutta", поскольку последнее является псевдонимом первого и оба соответствуют Индии; однако он должен содержать как "Africa/Abidjan", так и "Atlantic/Reykjavik", поскольку они находятся в разных странах, несмотря на то, что последнее также является псевдонимом первого.

Ссылки:

• База данных часовых поясов IANA
• UTS 35, Идентификаторы часовых поясов

Поддерживаемые идентификаторы единиц измерения

Ниже приведены все значения, которые обычно поддерживаются браузерами для ключа unit. Эти значения могут использоваться для параметра unit при создании объектов, таких как Intl.NumberFormat. Этот список является подмножеством CLDR, явно санкционированным спецификацией ECMA-402, поэтому все реализации должны быть согласованными.

• acre
• bit
• byte
• celsius
• centimeter
• day
• degree
• fahrenheit
• fluid-ounce
• foot
• gallon
• gigabit
• gigabyte
• gram
• hectare
• hour
• inch
• kilobit
• kilobyte
• kilogram
• kilometer
• liter
• megabit
• megabyte
• meter
• microsecond
• mile
• mile-scandinavian
• milliliter
• millimeter
• millisecond
• minute
• month
• nanosecond
• ounce
• percent
• petabyte
• pound
• second
• stone
• terabit
• terabyte
• week
• yard
• year

При указании единиц измерения можно также объединять две единицы с разделителем "-per-". Например, meter-per-second или liter-per-megabyte.

Ссылки:

• ECMA-402 санкционированные единицы
• Данные валидности единиц CLDR
• UTS 35, Идентификаторы единиц измерения

Исключения

RangeError

Выбрасывается, если в качестве параметра был передан неподдерживаемый ключ.

Примеры

Тестирование функций

Вы можете проверить, что метод поддерживается, сравнив его с undefined:

if (typeof Intl.supportedValuesOf !== "undefined") {
  // method is supported
}

Получить все значения для ключа

Чтобы получить поддерживаемые значения для календаря, вы вызываете метод с ключом "calendar". Затем вы можете перебирать возвращаемый массив, как показано ниже:

Intl.supportedValuesOf("calendar").forEach((calendar) => {
  // "buddhist", "chinese", "coptic", "dangi", etc.
});

Остальные значения получаются таким же образом:

Intl.supportedValuesOf("collation").forEach((collation) => {
  // "compat", "dict", "emoji", etc.
});

Intl.supportedValuesOf("currency").forEach((currency) => {
  // "ADP", "AED", "AFA", "AFN", "ALK", "ALL", "AMD", etc.
});

Intl.supportedValuesOf("numberingSystem").forEach((numberingSystem) => {
  // "adlm", "ahom", "arab", "arabext", "bali", etc.
});

Intl.supportedValuesOf("timeZone").forEach((timeZone) => {
  // "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", etc.
});

Intl.supportedValuesOf("unit").forEach((unit) => {
  // "acre", "bit", "byte", "celsius", "centimeter", etc.
});

Недопустимый ключ вызывает RangeError

try {
  Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
  // RangeError: invalid key: "someInvalidKey"
}

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

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

См. также

• Polyfill для Intl.supportedValuesOf в FormatJS
• Intl