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 resolvedOptions() Methode von Intl.NumberFormat Instanzen 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, das Eigenschaften enthält, die die während der Initialisierung dieses NumberFormat-Objekts berechneten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften, in der Reihenfolge, in der sie aufgeführt sind:

locale: Das BCP 47-Sprachtag für die tatsächlich verwendete Locale, ermittelt durch den Locale-Aushandlungsprozess. Nur der nu Unicode-Erweiterungsschlüssel, falls angefordert, kann im Ergebnis enthalten sein.
numberingSystem: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde oder mithilfe des Unicode-Erweiterungsschlüssels "nu", mit der nötigen Voreinstellung ergänzt. Es ist ein unterstütztes Zahlensystem für diese Locale. Der Standard ist von der Locale abhängig.
style: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist entweder "decimal", "percent", "currency" oder "unit". Der Standard ist "decimal".
currency Optional: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde. Es 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 keine Voreinstellung.
currencyDisplay Optional: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist nur vorhanden, wenn style "currency" ist. Es ist entweder "code", "symbol", "narrowSymbol" oder "name". Der Standard ist "symbol".
currencySign Optional: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist nur vorhanden, wenn style "currency" ist. Es ist entweder "standard" oder "accounting". Der Standard ist "standard".
unit Optional: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde. Es ist nur vorhanden, wenn style "unit" ist. Es ist ein genehmigter Einheit-Identifikator aus der vollen CLDR Liste. Es ist erforderlich, wenn style "unit" ist, daher gibt es keine Voreinstellung.
unitDisplay Optional: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist nur vorhanden, wenn style "unit" ist. Es ist entweder "short", "narrow" oder "long". Der Standard ist "short".
minimumIntegerDigits: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist eine Ganzzahl zwischen 1 und 21. Der Standard ist 1.
minimumFractionDigits, maximumFractionDigits Optional: Der Wert, der für diese Eigenschaften im options-Argument angegeben wurde, mit den nötigen Voreinstellungen ergänzt. Sie sind nur vorhanden, wenn nötig; siehe Zahlenoptionen. Es ist eine Ganzzahl zwischen 0 und 100.
minimumSignificantDigits, maximumSignificantDigits Optional: Der Wert, der für diese Eigenschaften im options-Argument angegeben wurde, mit den nötigen Voreinstellungen ergänzt. Sie sind nur vorhanden, wenn nötig; siehe Zahlenoptionen. Es ist eine Ganzzahl zwischen 1 und 21.
useGrouping: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt, 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 ansonsten "auto".
notation: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist entweder "standard", "scientific", "engineering" oder "compact". Der Standard ist "standard".
compactDisplay Optional: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist nur vorhanden, wenn notation "compact" ist. Es ist entweder "short" oder "long". Der Standard ist "short".
signDisplay: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist entweder "auto", "always", "exceptZero", "negative" oder "never". Der Standard ist "auto".
roundingIncrement: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist eine der Optionen 1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500, und 5000. Der Standard ist 1.
roundingMode: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist eine der Optionen "ceil", "floor", "expand", "trunc", "halfCeil", "halfFloor", "halfExpand", "halfTrunc", und "halfEven". Der Standard ist "halfExpand".
roundingPriority: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist entweder "auto", "morePrecision" oder "lessPrecision". Der Standard ist "auto".
trailingZeroDisplay: Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit der nötigen Voreinstellung ergänzt. Es ist entweder "auto" oder "stripIfInteger". Der Standard ist "auto".

Beispiele

Verwendung der Methode `resolvedOptions`

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

Browser-Kompatibilität

Siehe auch

Intl.NumberFormat