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és Unicode pour les calendriers
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é islamicc est désormais dépréciée et il faut utiliser islamic-civil à la place.

islamicc

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.

js
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é :

js
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

Voir aussi