Intl.Locale.prototype.calendar

Свойство-аксессор calendar экземпляров Intl.Locale возвращает тип календаря для этой локали.

Описание

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

Значение свойства calendar устанавливается во время конструирования либо через ключ ca идентификатора локали, либо через опцию calendar конструктора Intl.Locale(). Последнее имеет приоритет, если оба присутствуют; и если ни один из них не присутствует, свойство имеет значение undefined.

Сеттер-аксессор calendar является undefined. Вы не можете изменить это свойство напрямую.

Примеры

Как и другие подтеги локали, тип календаря может быть добавлен к объекту Intl.Locale через строку локали или аргумент объекта конфигурации конструктора.

Добавление типа календаря через строку локали

В спецификации строки локали Unicode, calendar является "подтегом расширения". Эти подтеги добавляют дополнительные данные о локали и добавляются к идентификаторам локали с использованием ключа расширения -u. Чтобы добавить тип календаря к исходной строке идентификатора локали, передаваемой в конструктор Intl.Locale(), сначала добавьте ключ расширения -u, если его нет. Затем добавьте расширение -ca, чтобы указать, что вы добавляете тип календаря. Наконец, добавьте тип календарной эры.

const locale = new Intl.Locale("fr-FR-u-ca-buddhist");
console.log(locale.calendar); // "buddhist"

Добавление типа календаря через аргумент объекта конфигурации

Конструктор Intl.Locale() имеет необязательный аргумент объекта конфигурации, который может содержать любой из нескольких типов расширений, включая календари. Установите свойство calendar объекта конфигурации на желаемую календарную эру, а затем передайте его в конструктор.

const locale = new Intl.Locale("fr-FR", { calendar: "buddhist" });
console.log(locale.calendar); // "buddhist"

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

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

См. также

• Intl.Locale
• Intl.Locale.prototype.getCalendars()
• Идентификатор календаря Unicode в спецификации языка разметки данных локали Unicode