Intl.Locale.prototype.getTimeZones()

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

Intl.Locale 实例的 getTimeZones() 方法会返回该区域设置支持的时区列表。

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

语法

js
getTimeZones()

参数

无。

返回值

一个字符串数组,表示相关 Locale 支持的时区,其中每个值都是一个 IANA 时区规范名称,按字母顺序排序。如果区域设置标识符不包含区域子标记,则返回值是 undefined

注意: Temporal 的标准化要求浏览器始终返回 IANA 数据库中的主要标识符,这可能会随时间而变化。有关更多信息,请参阅 时区和偏移量

示例

获取支持的时区

列出给定 Locale 支持的时区。

js
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getTimeZones()); // ["Africa/Cairo"]
js
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getTimeZones()); // ["Asia/Tokyo"]
js
const ar = new Intl.Locale("ar");
console.log(ar.getTimeZones()); // undefined

规范

规范
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getTimeZones

浏览器兼容性

另见