Intl.Locale : propriété calendar

Description

Bien que la plupart du monde utilise le calendrier grégorien, il existe plusieurs ères de calendriers régionaux utilisées dans le monde. Pour une liste des types de calendriers pris en charge, voir Intl.supportedValuesOf().

La valeur de la propriété calendar est définie au moment de la construction, soit par la clé ca de l'identifiant de locale, soit par l'option calendar du constructeur Intl.Locale(). Cette dernière prend le pas si les deux sont présentes ; et si aucune n'est présente, la propriété a pour valeur undefined.

Le mutateur d'accesseur de calendar est undefined. Vous ne pouvez pas modifier cette propriété directement.

Exemples

Comme pour les autres sous-balises de locale, le type de calendrier peut être ajouté à l'objet Intl.Locale par la chaîne de caractères de locale, soit par un objet de configuration passé en argument au constructeur.

Ajouter un type de calendrier à la chaîne de caractères de locale

Dans la spécification des chaînes de caractères de locale Unicode ^(angl.), calendar est un « sous-balise d'extension ». Ces sous-balises ajoutent des informations supplémentaires sur la locale et sont ajoutés aux identifiants de locale en utilisant la clé d'extension -u. Pour ajouter le type de calendrier à la chaîne d'identifiant de locale initiale passée au constructeur Intl.Locale(), ajoutez d'abord la clé d'extension -u si elle n'existe pas. Ensuite, ajoutez l'extension -ca pour indiquer que vous ajoutez un type de calendrier. Enfin, ajoutez le type d'ère du calendrier.

const locale = new Intl.Locale("fr-FR-u-ca-buddhist");
console.log(locale.calendar); // "buddhist"

Ajouter un type de calendrier à l'objet de configuration

Le constructeur Intl.Locale() accepte un argument optionnel de type objet de configuration, qui peut contenir plusieurs types d'extensions, y compris les calendriers. Définissez la propriété calendar de l'objet de configuration sur l'ère de calendrier souhaitée, puis passez-le au constructeur.

const locale = new Intl.Locale("fr-FR", { calendar: "buddhist" });
console.log(locale.calendar); // "buddhist"

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Intl.Locale
• La méthode Intl.Locale.prototype.getCalendars()
• Identifiants Unicode pour les calendriers ^(angl.) dans la spécification Unicode du langage de balisage des données de locale Unicode