Intl.Locale.prototype.hourCycle

基线 广泛可用

此功能已得到很好的确立,并且可以在许多设备和浏览器版本中使用。它自以下日期起在所有浏览器中都可用: 2020 年 9 月.

hourCycle 访问器属性Intl.Locale实例返回此区域设置的小时周期类型。

描述

全世界使用两种主要的时间计量约定(时钟):12 小时制和 24 小时制。hourCycle属性的值在构造时设置,可以通过区域设置标识符的hc键或Intl.Locale()构造函数的hourCycle选项设置。如果两者都存在,则后者优先;如果两者都不存在,则该属性的值为undefined

有关支持的小时周期类型的列表,请参阅Intl.Locale.prototype.getHourCycles()

hourCycle的设置访问器为undefined。无法直接更改此属性。

示例

与其他区域设置子标签一样,可以通过区域设置字符串或构造函数的配置对象参数将小时周期类型添加到Intl.Locale对象中。

通过区域设置字符串添加小时周期

Unicode 区域设置字符串规范中,小时周期类型是区域设置键“扩展子标签”。这些子标签添加了有关区域设置的附加数据,并通过使用-u扩展添加到区域设置标识符中。因此,可以通过将-u扩展键添加到传递给Intl.Locale()构造函数的初始区域设置标识符字符串中来添加小时周期类型。要添加小时周期类型,首先将-u扩展键添加到字符串中。接下来,添加-hc扩展以指示您正在添加小时周期。最后,将小时周期类型添加到字符串中。

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

通过配置对象参数添加小时周期

Intl.Locale()构造函数有一个可选的配置对象参数,其中可以包含任何几种扩展类型,包括小时周期类型。将配置对象的hourCycle属性设置为所需的小时周期类型,然后将其传递给构造函数。

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

规范

规范
ECMAScript 国际化 API 规范
# sec-Intl.Locale.prototype.hourCycle

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅