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 对象还没有 hourCyclegetHourCycles() 将列出给定 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 Locale Info Proposal
# sec-Intl.Locale.prototype.getHourCycles

浏览器兼容性

另见