Intl.Locale : méthode getCalendars()
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La méthode getCalendars() des instances de Intl.Locale retourne une liste d'un ou plusieurs identifiants de calendrier uniques pour cette locale.
Note :
Dans certaines versions de certains navigateurs, cette méthode était implémentée comme une propriété d'accesseur appelée calendars. Cependant, comme elle retourne un nouveau tableau à chaque accès, elle est maintenant implémentée comme une méthode pour éviter la situation où locale.calendars === locale.calendars retourne false. Consultez le tableau de compatibilité des navigateurs pour plus de détails.
Syntaxe
getCalendars()
Paramètres
Aucun.
Valeur de retour
Un tableau de chaînes de caractères représentant tous les calendriers couramment utilisés pour la Locale, triés par ordre de préférence décroissant. Si la Locale possède déjà un calendar, alors le tableau retourné contient cette seule valeur.
Pour une liste des types de calendriers pris en charge, voir Intl.supportedValuesOf().
Exemples
Obtenir la liste des calendriers pris en charge
Si l'objet Locale ne possède pas déjà un calendar, getCalendars() liste tous les calendriers couramment utilisés pour la Locale donnée. Pour des exemples de définition explicite d'un calendar, voir les exemples de calendar.
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getCalendars()); // ["gregory", "coptic", "islamic", "islamic-civil", "islamic-tbla"]
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getCalendars()); // ["gregory", "japanese"]
Spécifications
| Spécification |
|---|
| Intl Locale Info Proposal # sec-Intl.Locale.prototype.getCalendars |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.Locale - La propriété
Intl.Locale.prototype.calendar - Identifiants de calendrier Unicode (angl.) dans la spécification du langage de balisage des données de locale Unicode