Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Intl.DurationFormat : méthode resolvedOptions()

Baseline 2025
Newly available

Depuis March 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La méthode resolvedOptions() des instances de Intl.DurationFormat retourne un nouvel objet avec des propriétés reflétant les options calculées lors de l'initialisation de cet objet DurationFormat.

Syntaxe

js
resolvedOptions()

Paramètres

Aucun.

Valeur de retour

Un nouvel objet avec des propriétés reflétant les options calculées lors de l'initialisation de cet objet DurationFormat. L'objet possède les propriétés suivantes, dans l'ordre indiqué :

locale

Le balise BCP 47 language tag pour la locale effectivement utilisée, déterminée par le processus de négociation de la locale. Seule la clé d'extension Unicode nu, si demandée, peut être incluse dans la sortie.

numberingSystem

La valeur fournie pour cette propriété dans l'argument options, ou en utilisant la clé d'extension Unicode "nu", avec la valeur par défaut complétée si nécessaire. Il s'agit d'un système de numérotation pris en charge pour cette locale. La valeur par défaut dépend de la locale.

style

La valeur fournie pour cette propriété dans l'argument options, avec la valeur par défaut complétée si nécessaire. Elle peut être "long", "short", "narrow" ou "digital". La valeur par défaut est "short".

years, yearsDisplay, months, monthsDisplay, weeks, weeksDisplay, days, daysDisplay, hours, hoursDisplay, minutes, minutesDisplay, seconds, secondsDisplay, milliseconds, millisecondsDisplay, nanoseconds, nanosecondsDisplay

Les valeurs fournies pour ces propriétés dans l'argument options, avec les valeurs par défaut complétées si nécessaire. Pour les valeurs valides et les valeurs par défaut de chacune, voir l'argument options du constructeur.

fractionalDigits Facultatif

La valeur fournie pour cette propriété dans l'argument options. Elle n'est présente que si elle est définie dans options. Il s'agit d'un entier de 0 à 9 inclus.

Exemples

Utiliser la méthode resolvedOptions()

js
const duration = new Intl.DurationFormat("en");
const usedOptions = duration.resolvedOptions();

usedOptions.locale; // "en"
usedOptions.numberingSystem; // "latn"
usedOptions.years; // "long"
usedOptions.yearsDisplay; // "auto"
usedOptions.style; // "long"

Spécifications

Specification
Intl.DurationFormat
# sec-Intl.DurationFormat.prototype.resolvedOptions

Compatibilité des navigateurs

Voir aussi