Intl.Locale.prototype.calendars

The Intl.Locale.prototype.calendars property is an accessor property which returns an array of one or more unique calendar identifiers for the Locale.

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 use islamic-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

No specification found

No specification data found for javascript.builtins.Intl.Locale.calendars.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

No compatibility data found for javascript.builtins.Intl.Locale.calendars.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

See also

© 2005–2021 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