Intl.Locale : méthode getTimeZones()
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 getTimeZones() des instances de Intl.Locale retourne une liste des fuseaux horaires pris en charge pour cette locale.
Note :
Dans certaines versions de certains navigateurs, cette méthode était implémentée en tant que propriété d'accès appelée timeZones. Cependant, comme elle retourne un nouveau tableau à chaque accès, elle est maintenant implémentée en tant que méthode pour éviter la situation où locale.timeZones === locale.timeZones retourne false. Consultez le tableau de compatibilité des navigateurs pour plus de détails.
Syntaxe
getTimeZones()
Paramètres
Aucun.
Valeur de retour
Un tableau de chaînes de caractères représentant les fuseaux horaires pris en charge pour la Locale associée, chaque valeur étant un nom canonique de fuseau horaire IANA, trié par ordre alphabétique. Si l'identifiant de la locale ne contient pas de sous-étiquette de région, la valeur renvoyée est undefined.
Note :
La normalisation de Temporal exige que les navigateurs renvoient toujours l'identifiant principal dans la base de données IANA, qui peut changer au fil du temps. Consultez fuseaux horaires et décalages pour plus d'informations.
Exemples
Obtenir les fuseaux horaires pris en charge
Liste des fuseaux horaires pris en charge pour une Locale donnée.
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getTimeZones()); // ["Africa/Cairo"]
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getTimeZones()); // ["Asia/Tokyo"]
const ar = new Intl.Locale("ar");
console.log(ar.getTimeZones()); // undefined
Spécifications
| Spécification |
|---|
| Intl Locale Info Proposal # sec-Intl.Locale.prototype.getTimeZones |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.Locale - La base de données IANA pour les fuseaux horaires (angl.) sur Wikipedia