Intl.Locale.prototype.hourCycle
的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 的浏览器中加载。
另请参阅
Intl.Locale
Intl.Locale.prototype.getHourCycles()
- Unicode 小时周期标识符在 Unicode 区域设置数据标记语言规范中