Intl.Locale.prototype.calendar
==============================

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` (en-US). 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` (en-US) 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 with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `Intl.Locale` (en-US)
* Identifiants Unicode pour les calendriers