MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Intl.DateTimeFormat.prototype.resolvedOptions()

Une erreur de script s'est produite sur cette page. En attendant qu'elle soit traitée par les éditeurs du site, vous pouvez consulter le contenu partiel ci-dessous.

{{JSRef}}

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 {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}}.

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 {{jsxref("DateTimeFormat", "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é ou {{jsxref("undefined")}} (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 pas undefined.
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"
usedOption.numberingSystem; // "latn"
usedOptions.timeZone;       // "UTC"
usedOptions.month;          // "numeric"

Spécifications

Spécification État Commentaires
{{SpecName('ES Int 1.0', '#sec-12.3.3', 'Intl.DateTimeFormat.prototype.resolvedOptions')}} {{Spec2('ES Int 1.0')}} Définition initiale.
{{SpecName('ES Int 2.0', '#sec-Intl.DateTimeFormat.prototype.resolvedOptions', 'Intl.DateTimeFormat.prototype.resolvedOptions')}} {{Spec2('ES Int 2.0')}}  
{{SpecName('ES Int Draft', '#sec-Intl.DateTimeFormat.prototype.resolvedOptions', 'Intl.DateTimeFormat.prototype.resolvedOptions')}} {{Spec2('ES Int Draft')}}  

Compatibilité des navigateurs

{{CompatibilityTable}}
Fonctionnalité Chrome Firefox (Gecko) Edge Internet Explorer Opera Safari (WebKit)
Support simple {{CompatChrome("24")}} {{CompatGeckoDesktop("29")}} 12 {{CompatIE("11")}} {{CompatOpera("15")}} {{CompatSafari("10")}}
Calcul de timezone {{CompatChrome("35")}} {{CompatGeckoDesktop("53"}} 14 {{CompatNo}} {{CompatOpera("30")}} {{CompatSafari("10")}}
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) Edge IE Phone Opera Mobile Safari Mobile
Support simple {{CompatNo}} {{CompatChrome("26")}} {{CompatGeckoMobile("56")}} {{CompatUnknown}} {{CompatNo}} {{CompatNo}} 10

Voir aussi

  • {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}}

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, lsda123453
 Dernière mise à jour par : SphinxKnight,