Intl.Locale.prototype.getCalendars()
Базовый уровень Недавно стало доступно
Эта функция работает на последних устройствах и версиях браузеров. Эта функция может не работать на старых устройствах или версиях браузеров. Она доступна в браузерах с июля 2026 года.
Метод getCalendars() экземпляров Intl.Locale возвращает список одного или нескольких уникальных идентификаторов календаря для данной локали.
Примечание: В некоторых версиях некоторых браузеров этот метод был реализован как свойство доступа под названием calendars. Однако, поскольку он возвращает новый массив при каждом обращении, теперь он реализован как метод, чтобы избежать ситуации, когда locale.calendars === locale.calendars возвращает false. Подробности см. в таблице совместимости браузеров.
Синтаксис
getCalendars()
Параметры
Нет.
Возвращаемое значение
Массив строк, представляющий все календари, обычно используемые для Locale, отсортированные в порядке убывания предпочтения. Если у Locale уже есть calendar, то возвращаемый массив содержит это единственное значение.
Список поддерживаемых типов календарей см. в Intl.supportedValuesOf().
Примеры
Получение поддерживаемых календарей
Если у объекта Locale еще нет calendar, getCalendars() перечисляет все обычно используемые календари для данной Locale. Примеры явного установки calendar см. в примерах calendar.
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getCalendars()); // ["gregory", "coptic", "islamic", "islamic-civil", "islamic-tbla"]
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getCalendars()); // ["gregory", "japanese"]
Спецификации
Совместимость с браузерами
| Настольные компьютеры | Мобильные устройства | Сервер | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | WebView на iOS | Bun | Deno | Node.js | |
getCalendars |
130
99Реализовано как свойство доступа. |
130
99Реализовано как свойство доступа. |
153 |
115
85Реализовано как свойство доступа. |
17
15.4–previewРеализовано как свойство доступа. |
130
99Реализовано как свойство доступа. |
153 |
86
68Реализовано как свойство доступа. |
17
15.4Реализовано как свойство доступа. |
28.0
18.0Реализовано как свойство доступа. |
130
99Реализовано как свойство доступа. |
17
15.4Реализовано как свойство доступа. |
1.0.0 |
2.1
1.19–2.6.7Реализовано как свойство доступа. |
24.0.0
18.0.0Реализовано как свойство доступа. |
См. также
Intl.LocaleIntl.Locale.prototype.calendar- Unicode Calendar Identifier в спецификации языка разметки данных Unicode locale
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getCalendars
