在此页

• 描述
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Intl.Locale.prototype.calendar property is an accessor property which returns the type of calendar used in the Locale .

描述

calendar property returns the part of the Locale that indicates the Locale 's calendar era. While most of the world uses the Gregorian calendar, there are several regional calendar eras used around the world. The following table shows all the valid Unicode calendar key strings, along with a description of the calendar era they represent.

Unicode calendar keys

Unicode calendar keys

Calendar key (name)	描述
buddhist	Thai Buddhist calendar
chinese	Traditional Chinese calendar
coptic	Coptic calendar
dangi	Traditional Korean calendar
ethioaa	Ethiopic calendar, Amete Alem (epoch approx. 5493 B.C.E)
ethiopic	Ethiopic calendar, Amete Mihret (epoch approx, 8 C.E.)
gregory	Gregorian calendar
hebrew	Traditional Hebrew calendar
indian	Indian calendar
islamic	Islamic calendar
islamic-umalqura	Islamic calendar, Umm al-Qura
islamic-tbla	Islamic calendar, tabular (intercalary years [2,5,7,10,13,16,18,21,24,26,29] - astronomical epoch)
islamic-civil	Islamic calendar, tabular (intercalary years [2,5,7,10,13,16,18,21,24,26,29] - civil epoch)
islamic-rgsa	Islamic calendar, Saudi Arabia sighting
iso8601	ISO calendar (Gregorian calendar using the ISO 8601 calendar week rules)
japanese	Japanese Imperial calendar
persian	Persian calendar
roc	Republic of China calendar
islamicc calendar key has been deprecated. Please use islamic-civil . islamicc	Civil (algorithmic) Arabic calendar

范例

Adding a calendar in the Locale string

Calendar eras fall under the category of locale key "extension keys". These keys add additional data about the locale, and are added to locale identifiers by using the -u extension. Thus, the calendar era type can be added to the inital locale identifier string that is passed into the Intl.Locale constructor. To add the calendar type, first add the -u extension to the string. Next, add the -ca extension to indicate that you are adding a calendar type. Finally, add the calendar era to the string.

let frBuddhist = new Intl.Locale("fr-FR-u-ca-buddhist");
console.log(frBuddhist.calendar); // Prints "buddhist"
					

Adding a calendar with a configuration object

Intl.Locale constructor has an optional configuration object argument, which can contain any of several extension types, including calendars. Set the calendar property of the configuration object to your desired calendar era, and then pass it into the constructor.

let frBuddhist = new Intl.Locale("fr-FR", {calendar: "buddhist"});
console.log(frBuddhist.calendar); // Prints "buddhist"
					

规范

规范
ECMAScript 国际化 API (ECMA-402)

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
calendar	Chrome 74	Edge 79	Firefox 75	IE No	Opera 62	Safari 14	WebView Android 74	Chrome Android 74	Firefox Android No	Opera Android 53	Safari iOS 14	Samsung Internet Android 11.0	nodejs 12.0.0 12.0.0 Before version 13.0.0, only the locale data for en-US is available by default. See the Locale() 构造函数 了解更多细节。

图例

完整支持

完整支持

不支持

不支持

见实现注意事项。

另请参阅

• Intl.Locale
• Unicode Calendar Identifiers

元数据

• 最后修改： Apr 21, 2020

相关话题

1. 标准内置对象
2. Intl
3. 方法
   1. Intl.getCanonicalLocales()
4. 相关页面：
5. Collator
6. DateTimeFormat
7. ListFormat
8. NumberFormat
9. PluralRules
10. RelativeTimeFormat
11. 继承：
12. Object
13. 特性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
14. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.valueOf()
    12. Object.setPrototypeOf()