Intl.Locale.prototype.getHourCycles()

可用性有限

此功能不是基线功能,因为它在一些使用最广泛的浏览器中无法正常工作。

getHourCycles() 方法是 Intl.Locale 实例的方法,它返回此区域设置的一个或多个唯一小时循环标识符列表。

注意:在某些版本的某些浏览器中,此方法被实现为名为 hourCycles 的访问器属性。但是,由于它在每次访问时都会返回一个新数组,因此现在将其实现为方法,以防止 locale.hourCycles === locale.hourCycles 返回 false 的情况。有关详细信息,请查看 浏览器兼容性表

语法

js
getHourCycles()

参数

无。

返回值

一个字符串数组,表示 Locale 通常使用的所有小时循环类型,按首选顺序降序排列。如果 Locale 已经有一个 hourCycle,则返回的数组包含该单个值。

以下是支持的小时循环类型的列表。

支持的小时循环类型

h12

使用 1–12 的小时制;对应于模式中的“h”。12 小时制,午夜从 12:00 am 开始。例如,在美国使用。

h23

使用 0–23 的小时制;对应于模式中的“H”。24 小时制,午夜从 0:00 开始。

h11

使用 0–11 的小时制;对应于模式中的“K”。12 小时制,午夜从 0:00 am 开始。主要在日本使用。

h24

使用 1–24 的小时制;对应于模式中的“k”。24 小时制,午夜从 24:00 开始。任何地方都不使用。

示例

获取支持的小时循环

如果 Locale 对象还没有 hourCycle,则 getHourCycles() 会列出给定 Locale 通常使用的小时循环标识符。有关显式设置 hourCycle 的示例,请参阅 hourCycle 示例

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

规范

规范
Intl 区域设置信息提案
# sec-Intl.Locale.prototype.getHourCycles

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅