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.

Die Methode resolvedOptions() von Instanzen des Intl.NumberFormat gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung dieses NumberFormat-Objekts berechneten Optionen widerspiegeln.

Probieren Sie es aus

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"

Syntax

resolvedOptions()

Parameter

Keine.

Rückgabewert

Ein neues Objekt mit Eigenschaften, die die während der Initialisierung dieses NumberFormat-Objekts berechneten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften in der Reihenfolge, in der sie aufgelistet sind:

locale: Der BCP 47-Sprachcode für das tatsächlich verwendete Gebietsschema, bestimmt durch den locale negotiation-Prozess. Nur der Unicode-Erweiterungsschlüssel nu, falls angefordert, kann im Ausgabe enthalten sein.
numberingSystem: Der in der options-Argument bereitgestellte Wert oder unter Verwendung des Unicode-Erweiterungsschlüssels "nu", mit standardmäßiger Vervollständigung, falls erforderlich. Es ist ein unterstütztes Zahlensystem für dieses Gebietsschema. Der Standard ist lokal abhängig.
style: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Es ist entweder "decimal", "percent", "currency" oder "unit". Der Standard ist "decimal".
currency Optional: Der in der options-Argument bereitgestellte Wert. Er ist nur vorhanden, wenn style "currency" ist. Es ist ein ISO 4217-Währungscode; siehe Intl.supportedValuesOf(). Es ist erforderlich, wenn style "currency" ist, daher gibt es keinen Standard.
currencyDisplay Optional: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Er ist nur vorhanden, wenn style "currency" ist. Es ist entweder "code", "symbol", "narrowSymbol" oder "name". Der Standard ist "symbol".
currencySign Optional: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Er ist nur vorhanden, wenn style "currency" ist. Es ist entweder "standard" oder "accounting". Der Standard ist "standard".
unit Optional: Der in der options-Argument bereitgestellte Wert. Er ist nur vorhanden, wenn style "unit" ist. Es ist ein sanctioned unit identifier aus der vollständigen CLDR-Liste. Es ist erforderlich, wenn style "unit" ist, daher gibt es keinen Standard.
unitDisplay Optional: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Er ist nur vorhanden, wenn style "unit" ist. Es ist entweder "short", "narrow" oder "long". Der Standard ist "short".
minimumIntegerDigits: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Es ist eine ganze Zahl zwischen 1 und 21. Der Standard ist 1.
minimumFractionDigits, maximumFractionDigits Optional: Der in der options-Argument bereitgestellte Wert für diese Eigenschaften, mit standardmäßigen Vervollständigungen, falls erforderlich. Sie sind nur vorhanden, wenn notwendig; siehe digit options. Es ist eine ganze Zahl zwischen 0 und 100.
minimumSignificantDigits, maximumSignificantDigits Optional: Der in der options-Argument bereitgestellte Wert für diese Eigenschaften, mit standardmäßigen Vervollständigungen, falls erforderlich. Sie sind nur vorhanden, wenn notwendig; siehe digit options. Es ist eine ganze Zahl zwischen 1 und 21.
useGrouping: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich, und mit einigen normalisierten Werten. Es ist entweder "always", "auto", "min2" oder der boolesche Wert false. Der Standard ist "min2", wenn notation "compact" ist, und "auto" sonst.
notation: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Es ist entweder "standard", "scientific", "engineering" oder "compact". Der Standard ist "standard".
compactDisplay Optional: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Er ist nur vorhanden, wenn notation "compact" ist. Es ist entweder "short" oder "long". Der Standard ist "short".
signDisplay: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Es ist entweder "auto", "always", "exceptZero", "negative" oder "never". Der Standard ist "auto".
roundingIncrement: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Es ist einer von 1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500 und 5000. Der Standard ist 1.
roundingMode: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Es ist einer von "ceil", "floor", "expand", "trunc", "halfCeil", "halfFloor", "halfExpand", "halfTrunc" und "halfEven". Der Standard ist "halfExpand".
roundingPriority: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Es ist entweder "auto", "morePrecision" oder "lessPrecision". Der Standard ist "auto".
trailingZeroDisplay: Der in der options-Argument bereitgestellte Wert, mit standardmäßiger Vervollständigung, falls erforderlich. Es ist entweder "auto" oder "stripIfInteger". Der Standard ist "auto".

Beispiele

Verwendung der `resolvedOptions`-Methode

// Create a NumberFormat
const de = new Intl.NumberFormat("de-DE", {
  style: "currency",
  currency: "USD",
  maximumFractionDigits: 2,
  roundingIncrement: 5,
  roundingMode: "halfCeil",
});

// Resolve the options
const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.numberingSystem); // "latn"
console.log(usedOptions.compactDisplay); // undefined ("notation" not set to "compact")
console.log(usedOptions.currency); // "USD"
console.log(usedOptions.currencyDisplay); // "symbol"
console.log(usedOptions.currencySign); // "standard"
console.log(usedOptions.minimumIntegerDigits); // 1
console.log(usedOptions.minimumFractionDigits); // 2
console.log(usedOptions.maximumFractionDigits); // 2
console.log(usedOptions.minimumSignificantDigits); // undefined (maximumFractionDigits is set)
console.log(usedOptions.maximumSignificantDigits); // undefined (maximumFractionDigits is set)
console.log(usedOptions.notation); // "standard"
console.log(usedOptions.roundingIncrement); // 5
console.log(usedOptions.roundingMode); // halfCeil
console.log(usedOptions.roundingPriority); // auto
console.log(usedOptions.signDisplay); // "auto"
console.log(usedOptions.style); // "currency"
console.log(usedOptions.trailingZeroDisplay); // auto
console.log(usedOptions.useGrouping); // auto

Spezifikationen

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

Browser-Kompatibilität

Siehe auch

Intl.NumberFormat