CKTIS / JavaScript
Intl.DateTimeFormat : consulter les options effectives
Utilisez `resolvedOptions()` pour connaître les réglages de date et d’heure réellement utilisés par une instance, sans les déduire des arguments du constructeur.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
formatter.resolvedOptions()Intl.DateTimeFormat.prototype.resolvedOptions est une méthode d’instance sans argument. Chaque appel renvoie un nouvel objet ordinaire contenant les réglages déterminés à la création du formateur. Modifier le résultat ne change pas le formateur. Contrairement à format(), cette méthode ne prend pas de date et ne produit pas de texte formaté. Un appel sans liaison ou avec un this incompatible, tel que {}, déclenche une TypeError.
Le résultat contient locale (l’étiquette de langue BCP 47 effectivement choisie), calendar, numberingSystem et timeZone. Ce n’est pas une copie des arguments du constructeur : la négociation des paramètres régionaux et les valeurs par défaut peuvent modifier le résultat. Sans timeZone explicite, le formateur prend à sa création le fuseau par défaut de l’environnement d’exécution. Un identifiant de fuseau peut être normalisé : il ne correspond donc pas forcément à la chaîne fournie.
Sans dateStyle ni timeStyle, les propriétés comme year, month et hour reflètent le modèle retenu ; les composants inutilisés sont omis. Avec dateStyle ou timeStyle, le résultat indique les styles demandés sans les détailler en composants. Combiner un style avec une option de composant explicite telle que hour déclenche une TypeError dans le constructeur.
Si le modèle comprend une heure, le résultat contient hourCycle et la valeur hour12 qui en découle, même lorsque timeStyle empêche l’apparition de la propriété hour. hour12 vaut true pour h11 et h12, et false pour h23 et h24. Sans heure, les deux propriétés sont omises. Pour le choix du cycle, l’option hour12 a priorité sur hourCycle et sur l’extension Unicode hc.
Servez-vous du résultat pour diagnostiquer les écarts entre environnements d’exécution. La prise en charge des options et les données régionales peuvent varier, et des options effectives identiques ne garantissent pas un texte formaté identique.
Exemples
const formatter = new Intl.DateTimeFormat("en-GB", {
timeZone: "UTC",
timeStyle: "short",
hour12: false,
});
const options = formatter.resolvedOptions();
console.log(options.timeZone);
console.log(options.timeStyle);
console.log(options.hour12);
console.log(Object.hasOwn(options, "hour"));
options.timeZone = "Asia/Tokyo";
console.log(formatter.resolvedOptions().timeZone);Résultat
UTC short false false UTC
Le code affiche successivement `UTC`, `short`, `false`, `false` et `UTC`. Le premier `false` indique un format sur 24 heures ; le second signale l’absence de propriété propre `hour`. L’affectation de `Asia/Tokyo` ne modifie que l’objet renvoyé.
Leçons associées
- JavaScript · Leçon 25 · Avancé · Version : 4
Sources
- ECMAScript® 2024 Internationalization API Specification — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — CreateDateTimeFormat