Intl.NumberFormat.prototype.resolvedOptions()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

La méthode Intl.NumberFormat.prototype.resolvedOptions() renvoie un nouvel objet dont les propriétés correspondent aux options de locales et de format calculées à l'initialisation de l'objet Intl.NumberFormat.

Exemple interactif

Syntaxe

js
numberFormat.resolvedOptions();

Valeur de retour

Un objet dont les propriétés correspondent aux options de locale et de format calculées lors de l'initialisation de l'objet Intl.NumberFormat.

Description

Cette méthode renvoie un objet composé des propriétés suivantes :

locale

La balise de langue BCP 47 qui est utilisée. Si des extensions Unicode avaient été rajoutées à la balise BCP 47 demandée, les paires de clés-valeurs qui ont été demandées et qui sont supportées sont inscrites dans locale.

numberingSystem

La valeur requise via l'extension Unicode "nu" ou celle qui est utilisée par défaut.

style, useGrouping

Les valeurs fournies pour ces propriétés via l'argument options ou bien les valeurs par défaut.

currency, currencyDisplay

Les valeurs fournies pour ces propriétés via l'argument options ou bien les valeurs par défaut. Ces valeurs sont présentes uniquement si style vaut "currency".

Un seul des deux groupes suivants est inclus dans les propriétés :

minimumIntegerDigits, minimumFractionDigits, maximumFractionDigits

Les valeurs fournies pour ces propriétés via l'argument options ou bien les valeurs par défaut. Ces propriétés ne sont présentes que si minimumSignificantDigits ou maximumSignificantDigits n'ont pas été fournies à l'argument options.

minimumSignificantDigits, maximumSignificantDigits

Les valeurs fournies pour ces propriétés via l'argument options ou bien les valeurs par défaut. Ces propriétés sont présentes si au moins une d'entre elles a été fournie via l'argument options.

Exemples

Utiliser la méthode resolvedOptions()

js
var de = new Intl.NumberFormat("de-DE");
var usedOptions = de.resolvedOptions();

usedOptions.locale; // "de-DE"
usedOptions.numberingSystem; // "latn"
usedOption.style; // "decimal"
usedOptions.minimumIntegerDigits; // 1
usedOptions.minimumFractionDigits; // 0
usedOptions.maximumFractionDigits; // 3
usedOptions.useGrouping; // true

Spécifications

Specification
ECMAScript Internationalization API Specification
# sec-intl.numberformat.prototype.resolvedoptions

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi