Intl.Locale.prototype.getCalendars()

可用性有限

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

**getCalendars()** 是 Intl.Locale 实例的方法，它返回此区域设置的一个或多个唯一日历标识符列表。

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

语法

js
getCalendars()

参数

无。

返回值

一个字符串数组，表示 Locale 通常使用的所有日历，按首选项降序排列。如果 Locale 已经有 calendar，则返回的数组包含该单个值。

以下是受支持的日历纪元类型的列表。

支持的日历类型

buddhist

泰国佛教历

chinese

传统中国历

coptic

科普特历

dangi

传统韩国历

ethioaa

埃塞俄比亚历，Amete Alem（纪元约公元前 5493 年）

ethiopic

埃塞俄比亚历，Amete Mihret（纪元约公元 8 年）

gregory

公历

hebrew

传统希伯来历

indian

印度历

islamic

伊斯兰历

islamic-umalqura

伊斯兰历，Umm al-Qura

islamic-tbla

伊斯兰历，表格（闰年 [2,5,7,10,13,16,18,21,24,26,29] - 天文纪元）

islamic-civil

伊斯兰历，表格（闰年 [2,5,7,10,13,16,18,21,24,26,29] - 公元纪元）

islamic-rgsa

伊斯兰历，沙特阿拉伯观测

iso8601

ISO 历（使用 ISO 8601 日历周规则的公历）

japanese

日本皇历

persian

波斯历

roc

中华民国历

islamicc

中华民国历

警告：islamicc 日历键已弃用。请使用 islamic-civil。

示例

获取支持的日历

如果 Locale 对象还没有 calendar，则 getCalendars() 会列出给定 Locale 的所有常用日历。有关显式设置 calendar 的示例，请参阅 calendar 示例。

js
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getCalendars()); // ["gregory", "coptic", "islamic", "islamic-civil", "islamic-tbla"]
js
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getCalendars()); // ["gregory", "japanese"]

规范

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

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅