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

js
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

Das BCP 47-Sprachtag für das tatsächlich verwendete Gebietsschema, ermittelt durch den locale negotiation-Prozess. Nur der nu Unicode-Erweiterungsschlüssel, falls angefordert, kann in der Ausgabe enthalten sein.

numberingSystem

Der für diese Eigenschaft im options-Argument angegebene Wert oder unter Verwendung des Unicode-Erweiterungsschlüssels "nu" mit standardmäßiger Auffüllung bei Bedarf. Es ist ein unterstütztes numbering system für dieses Gebietsschema. Der Standard ist gebietsschemaabhängig.

style

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Es ist entweder "decimal", "percent", "currency" oder "unit". Der Standard ist "decimal".

currency Optional

Der für diese Eigenschaft im options-Argument angegebene Wert. Sie ist nur vorhanden, wenn style "currency" ist. Es ist ein ISO 4217-Währungscode; siehe Intl.supportedValuesOf(). Sie ist erforderlich, wenn style "currency" ist, daher gibt es keinen Standard.

currencyDisplay Optional

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Sie ist nur vorhanden, wenn style "currency" ist. Sie ist entweder "code", "symbol", "narrowSymbol" oder "name". Der Standard ist "symbol".

currencySign Optional

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Sie ist nur vorhanden, wenn style "currency" ist. Sie ist entweder "standard" oder "accounting". Der Standard ist "standard".

unit Optional

Der für diese Eigenschaft im options-Argument angegebene Wert. Sie ist nur vorhanden, wenn style "unit" ist. Es ist ein sanctioned unit identifier aus der full CLDR list. Sie ist erforderlich, wenn style "unit" ist, daher gibt es keinen Standard.

unitDisplay Optional

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Sie ist nur vorhanden, wenn style "unit" ist. Sie ist entweder "short", "narrow" oder "long". Der Standard ist "short".

minimumIntegerDigits

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Es ist eine Ganzzahl zwischen 1 und 21. Der Standard ist 1.

minimumFractionDigits, maximumFractionDigits Optional

Die für diese Eigenschaften im options-Argument angegebenen Werte, mit standardmäßiger Auffüllung bei Bedarf. Sie sind nur vorhanden, wenn erforderlich; siehe digit options. Es ist eine Ganzzahl zwischen 0 und 100.

minimumSignificantDigits, maximumSignificantDigits Optional

Die für diese Eigenschaften im options-Argument angegebenen Werte, mit standardmäßiger Auffüllung bei Bedarf. Sie sind nur vorhanden, wenn erforderlich; siehe digit options. Es ist eine Ganzzahl zwischen 1 und 21.

useGrouping

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf, und mit einigen normalisierten Werten. Es ist entweder "always", "auto", "min2" oder der Boolean false. Der Standard ist "min2", wenn notation "compact" ist, und "auto" andernfalls.

notation

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Es ist entweder "standard", "scientific", "engineering" oder "compact". Der Standard ist "standard".

compactDisplay Optional

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Sie ist nur vorhanden, wenn notation "compact" ist. Sie ist entweder "short" oder "long". Der Standard ist "short".

signDisplay

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Es ist entweder "auto", "always", "exceptZero", "negative" oder "never". Der Standard ist "auto".

roundingIncrement

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. 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 für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Es ist einer von "ceil", "floor", "expand", "trunc", "halfCeil", "halfFloor", "halfExpand", "halfTrunc" und "halfEven". Der Standard ist "halfExpand".

roundingPriority

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Es ist entweder "auto", "morePrecision" oder "lessPrecision". Der Standard ist "auto".

trailingZeroDisplay

Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßiger Auffüllung bei Bedarf. Es ist entweder "auto" oder "stripIfInteger". Der Standard ist "auto".

Beispiele

Verwendung der resolvedOptions-Methode

js
// 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