Intl.RelativeTimeFormat : méthode resolvedOptions()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2020.
La méthode resolvedOptions() des instances de Intl.RelativeTimeFormat retourne un nouvel objet dont les propriétés reflètent les options calculées lors de l'initialisation de cet objet RelativeTimeFormat.
Exemple interactif
const rtf1 = new Intl.RelativeTimeFormat("en", { style: "narrow" });
const options1 = rtf1.resolvedOptions();
const rtf2 = new Intl.RelativeTimeFormat("es", { numeric: "auto" });
const options2 = rtf2.resolvedOptions();
console.log(`${options1.locale}, ${options1.style}, ${options1.numeric}`);
// Résultat attendu : "en, narrow, always"
console.log(`${options2.locale}, ${options2.style}, ${options2.numeric}`);
// Résultat attendu : "es, long, auto"
Syntaxe
resolvedOptions()
Paramètres
Aucun.
Valeur de retour
Un nouvel objet dont les propriétés reflètent les options calculées lors de l'initialisation de cet objet RelativeTimeFormat. L'objet possède les propriétés suivantes, dans l'ordre dans lequel elles sont listées :
locale-
La balise de langue BCP 47 pour la locale réellement utilisée, déterminée par le processus de négociation de la locale. Seule la clé d'extension Unicode
nu, si elle est demandée, peut être incluse dans la sortie. style-
La valeur fournie pour cette propriété dans l'argument
options, avec les valeurs par défaut remplies si nécessaire. Elle peut être"long","short"ou"narrow". La valeur par défaut est"long". numeric-
La valeur fournie pour cette propriété dans l'argument
options, avec les valeurs par défaut remplies si nécessaire. Elle peut être"always"ou"auto". La valeur par défaut est"always". numberingSystem-
La valeur fournie pour cette propriété dans l'argument
options, ou en utilisant la clé d'extension Unicode"nu", avec les valeurs par défaut remplies si nécessaire. Il s'agit d'un système de numération pris en charge pour cette locale. La valeur par défaut dépend de la locale.
Exemples
Utiliser la méthode resolvedOptions()
const de = new Intl.RelativeTimeFormat("de-DE");
const usedOptions = de.resolvedOptions();
usedOptions.locale; // "de-DE"
usedOptions.style; // "long"
usedOptions.numeric; // "always"
usedOptions.numberingSystem; // "latn"
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-intl.relativetimeformat.prototype.resolvedoptions |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.RelativeTimeFormat