The Intl.Locale.prototype.calendars
property is an accessor property which returns an array of one or more unique calendar identifiers for the Locale
.
Intl.Locale.prototype.calendars
Description
The calendar
property returns an array of all supported calendars for the Locale
. The array items indicate the Locale
object's calendar era. The following table shows all valid Unicode calendar key strings, along with a description of the calendar era they represent.
Unicode calendar keys
-
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
-
Civil (algorithmic) Arabic calendar
-
islamicc
-
Civil (algorithmic) Arabic calendar
Warning: The
islamicc
calendar key has been deprecated. Please useislamic-civil
.
Examples
Obtaining supported calendars
List supported calendars for a given Locale
.
let arEG = new Intl.Locale("ar-EG"); console.log(arEG.calendars); // logs ["gregory", "coptic", "islamic", "islamic-civil", "islamic-tbla"]
let jaJP = new Intl.Locale("ja-JP"); console.log(jaJP.calendars); // logs ["gregory", "japanese"]
Specifications
Browser compatibility
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | Deno | Node.js | |
calendars |
99
92-99
|
99
92-99
|
No
|
No
|
85
78-85
|
15.4
|
99
|
99
92-99
|
No
|
No
|
15.4
|
No
|
No
|
No
|
See also
© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/calendars