Intl.Locale.prototype.calendars
The Intl.Locale.prototype.calendars
accessor property returns a list of one or more unique calendar identifiers for the Locale
.
Description
The calendars
property returns an array of all calendars commonly used for the Locale
, sorted in descending preference. If the Locale
already has a calendar
, then the returned array contains that single value.
Below is a list of the supported calendar era types.
Supported calendar types
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
If the Locale
object doesn't have a calendar
already, the calendars
property lists all commonly-used calendars for the given Locale
. For examples of explicitly setting a calendar
, see calendar
examples.
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.calendars); // ["gregory", "coptic", "islamic", "islamic-civil", "islamic-tbla"]
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.calendars); // ["gregory", "japanese"]
Specifications
Specification |
---|
Intl Locale Info Proposal # sec-Intl.Locale.prototype.calendars |
Browser compatibility
BCD tables only load in the browser