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

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