Intl.Locale.prototype.hourCycle

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

Описание

По всему миру используются 2 основных типа соглашений о ведении времени (часов): 12-часовой формат и 24-часовой формат. Список поддерживаемых типов циклов часа см. в Intl.Locale.prototype.getHourCycles().

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

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

Примеры

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

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

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

const locale = new Intl.Locale("fr-FR-u-hc-h23");
console.log(locale.hourCycle); // "h23"

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

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

const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"

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

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

См. также

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