La méthode Intl.DateTimeFormat.prototype.resolvedOptions()
renvoie un nouvel objet dont les propriétés reflètent les options de format et de locale pour les heures et dates, calculées pendant l'initialisation de l'objet Intl.DateTimeFormat
.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
dateTimeFormat.resolvedOptions()
Valeur de retour
Un nouvel objet dont les propriétés reflètent les options de format et de locale pour les heures et dates, calculées pendant l'initialisation de l'objet Intl.DateTimeFormat
Description
La valeur renvoyée par cette méthode contient les propriétés suivantes :
locale
- La balise de langue BCP 47 qui est réellement utilisée. Si des extensions Unicode étaient fournies avec la balise d'origine et sont supportées pour la locale utilisée, les paires de clés-valeurs seront incluses dans
locale
. calendar
numberingSystem
- Les valeurs demandées pour les extensions Unicode
"ca"
et"nu"
ou leurs valeurs par défaut. timeZone
- La valeur fournie par l'argument
options
pour cette propriété ouundefined
(qui représente le fuseau horaire de l'environnement) si aucune valeur n'a été fournie. Les applications ne doivent pas s'appuyer sur ce dernier cas. En effet, de futures versions pourraient renvoyer une chaîne de caractères représentant le fuseau horaire de l'environnement et non pasundefined
. hour12
- La valeur fournie pour cette propriété dans l'argument
options
. weekday
era
year
month
day
hour
minute
second
timeZoneName
- Les valeurs qui correspondent entre les propriétés de l'argument
options
et les combinaisons disponibles dans l'environnement pour les formats de date et d'heure pour la locale. Certaines de ces propriétés peuvent ne pas être présentes, cela indique que les composants indiqués ne seront pas représentés.
Exemples
Utiliser la méthode resolvedOptions()
var germanFakeRegion = new Intl.DateTimeFormat("de-XX", { timeZone: "UTC" }); var usedOptions = germanFakeRegion.resolvedOptions(); usedOptions.locale; // "de" usedOptions.calendar; // "gregory" usedOptions.numberingSystem; // "latn" usedOptions.timeZone; // "UTC" usedOptions.month; // "numeric"
Spécifications
Compatibilité des navigateurs
Ordinateur | Mobile | Serveur | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Support simple | Chrome Support complet 24 | Edge Support complet 12 | Firefox Support complet 29 | IE Support complet 11 | Opera Support complet 15 | Safari Support complet 10 | WebView Android Aucun support Non | Chrome Android Support complet 26 | Edge Mobile Support complet Oui | Firefox Android Support complet 56 | Opera Android ? | Safari iOS Support complet 10 | Samsung Internet Android Support complet Oui | nodejs ? |
computed timeZone | Chrome Support complet 35 | Edge Support complet 14 | Firefox Support complet 53 | IE Aucun support Non | Opera Support complet 30 | Safari Support complet 10 | WebView Android ? | Chrome Android Support complet Oui | Edge Mobile ? | Firefox Android Support complet 56 | Opera Android ? | Safari iOS Support complet 10 | Samsung Internet Android ? | nodejs ? |
Légende
- Support complet
- Support complet
- Aucun support
- Aucun support
- Compatibilité inconnue
- Compatibilité inconnue