Intl.Locale.prototype.getHourCycles()

Базовая поддержка Недавно доступно

Эта функция работает на новейших устройствах и версиях браузеров. Эта функция может не работать на старых устройствах или версиях браузеров. Она доступна во всех браузерах с июля 2026 года.

Метод getHourCycles() экземпляров Intl.Locale возвращает список одного или нескольких уникальных идентификаторов циклов часов для данного локали.

Примечание: В некоторых версиях некоторых браузеров этот метод был реализован как свойство-аксессор под названием hourCycles. Однако, поскольку он возвращает новый массив при каждом доступе, теперь он реализован как метод, чтобы предотвратить ситуацию, когда locale.hourCycles === locale.hourCycles возвращает false. Подробности см. в таблице совместимости браузеров.

Синтаксис

getHourCycles()

Параметры

Нет.

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

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

Ниже приведен список поддерживаемых типов циклов часов.

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

h12: Система часов, использующая 1–12; соответствует 'h' в шаблонах. 12-часовой формат, где полночь начинается в 12:00. Как, например, используется в США.
h23: Система часов, использующая 0–23; соответствует 'H' в шаблонах. 24-часовой формат, где полночь начинается в 0:00.
h11: Система часов, использующая 0–11; соответствует 'K' в шаблонах. 12-часовой формат, где полночь начинается в 0:00. В основном используется в Японии.
h24: Система часов, использующая 1–24; соответствует 'k' в шаблоне. 24-часовой формат, где полночь начинается в 24:00. Нигде не используется.

Примеры

Получение поддерживаемых циклов часов

Если объект Locale еще не имеет hourCycle, getHourCycles() перечисляет все общепринятые идентификаторы циклов часов для данного Locale. Примеры явного установки hourCycle см. в примерах hourCycle.

const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getHourCycles()); // ["h12"]

const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getHourCycles()); // ["h23"]

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

Спецификация
Intl Locale Info Proposal # sec-Intl.Locale.prototype.getHourCycles

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

	Настольные					Мобильные							Сервер
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android	WebView на iOS	Bun	Deno	Node.js
`getHourCycles`	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.Locale
Intl.Locale.prototype.hourCycle
Идентификатор цикла часов Unicode в спецификации языка разметки данных Unicode

© 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/getHourCycles