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

const numberFormat1 = new Intl.NumberFormat("de-DE");
const options1 = numberFormat1.resolvedOptions();

console.log(options1.locale);
// Expected output (Firefox / Safari): "de-DE"
// Expected output (Chrome): "de"

console.log(options1.numberingSystem);
// Expected output: "latn"

console.log(options1.style);
// Expected output: "decimal"

Syntaxe

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()`

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® 2026 Internationalization API Specification # sec-intl.numberformat.prototype.resolvedoptions

Compatibilité des navigateurs

Voir aussi

Intl.NumberFormat