Intl.Locale.prototype.calendar
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
La propriété Intl.Locale.prototype.calendar
est une propriété (via un accesseur) qui renvoie le type de calendrier utilisé par l'instance de Locale
.
Description
La propriété calendar
renvoie la partie de la locale qui indique le calendrier utilisé. Bien que la plupart des régions utilise le calendrier grégorien, il existe différents calendriers utilisés. Le tableau qui suit indique les clés Unicode pour les différents calendriers ainsi qu'une description.
Clé Unicode | Description |
---|---|
buddhist |
Calendrier bouddhiste |
chinese |
Calendrier chinois traditionnel |
coptic |
Calendrier copte |
dangi |
Calendrier coréen traditionnel |
ethioaa |
Calendrier éthiopique, Amete Alem (an 0 situé environ à 5493 ans avant notre ère) |
ethiopic |
Calendrier éthiopique, Amete Mihret (an 0 situé environ à 8 ans de notre ère) |
gregory |
Calendrier grégorien |
hebrew |
Calendrier traditionnel hébreux |
indian |
Calendrier indien |
islamic |
Calendrier islamique |
islamic-umalqura |
Calendrier islamique, Umm al-Qura |
islamic-tbla |
Calendrier islamique tabulaire (années intercalaires [2,5,7,10,13,16,18,21,24,26,29] - origine des temps astronomique) |
islamic-civil |
Calendrier islamique tabulaire (années intercalaires [2,5,7,10,13,16,18,21,24,26,29] - origine des temps civile) |
islamic-rgsa |
Calendrier islamique vu de l'Arabie saoudite |
iso8601 |
Calendrier ISO (calendrier grégorien utilisant la numérotation des semaines ISO 8601) |
japanese |
Calendrier japonais impérial |
persian |
Calendrier perse |
roc |
Calendrier de la République de Chine |
Attention : La clé
|
Calendrier arabe civil (algorithmique) |
Exemples
Indiquer le calendrier via la chaîne de définition de la locale
Les calendriers font partie des « clés d'extension ». Ces clés permettent d'ajouter des informations supplémentaires aux locales et sont ajoutées via l'extension -u
. Ainsi, on peut indiquer le calendrier utilisé via la chaîne de locale passée comme argument au constructeur Intl.Locale
. Pour ce faire, on ajoutera d'abord -u
à la chaîne « courte » de la locale puis -ca
afin d'indiquer qu'on précise le calendrier et enfin la chaîne représentant la clé du calendrier.
let frBuddhist = new Intl.Locale("fr-FR-u-ca-buddhist");
console.log(frBuddhist.calendar); // affiche "buddhist" dans la console
Spécifier un calendrier grâce à un objet de configuration
Le constructeur Intl.Locale
peut utiliser un argument optionnel qui est un objet permettant de configurer la locale via différentes extensions dont les calendriers. En utilisant la propriété calendar
de cet objet, on définit le calendrier qui sera utilisé :
let frBuddhist = new Intl.Locale("fr-FR", { calendar: "buddhist" });
console.log(frBuddhist.calendar); // affiche "buddhist" dans la console
Spécifications
Specification |
---|
ECMAScript Internationalization API Specification # sec-Intl.Locale.prototype.calendar |
Compatibilité des navigateurs
BCD tables only load in the browser