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 numberFormat = new Intl.NumberFormat("de-DE");
const options = numberFormat.resolvedOptions();

console.log(options.locale);
// Expected output: "de-DE"

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

console.log(options.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 besitzt die folgenden Eigenschaften, in der Reihenfolge, in der sie aufgeführt sind:

locale: Das BCP 47-Sprach-Tag für das tatsächlich verwendete Gebietsschema, bestimmt durch den locale negotiation-Prozess. Nur der Unicode-Erweiterungsschlüssel nu, 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 Standardeinstellung, wo nötig. Es ist ein unterstütztes Nummerierungssystem für dieses Gebietsschema. Der Standard ist gebietsschemaabhängig.
style: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig. Es ist entweder "decimal", "percent", "currency", oder "unit". Der Standard ist "decimal".
currency Optional: Der für diese Eigenschaft im options-Argument angegebene Wert. 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 keinen Standardwert.
currencyDisplay Optional: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig. Es ist nur vorhanden, wenn style "currency" ist. Es ist entweder "code", "symbol", "narrowSymbol", oder "name". Der Standard ist "symbol".
currencySign Optional: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig. Es ist nur vorhanden, wenn style "currency" ist. Es ist entweder "standard" oder "accounting". Der Standard ist "standard".
unit Optional: Der für diese Eigenschaft im options-Argument angegebene Wert. Es ist nur vorhanden, wenn style "unit" ist. Es ist ein zugelassener Einheiten-Identifikator aus der vollständigen CLDR-Liste. Es ist erforderlich, wenn style "unit" ist, daher gibt es keinen Standardwert.
unitDisplay Optional: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig. Es ist nur vorhanden, wenn style "unit" ist. Es ist entweder "short", "narrow", oder "long". Der Standard ist "short".
minimumIntegerDigits: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig. 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 Standardeinstellung, wo nötig. Sie sind nur vorhanden, wenn nötig; 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 Standardeinstellung, wo nötig. Sie sind nur vorhanden, wenn nötig; siehe digit options. Es ist eine Ganzzahl zwischen 1 und 21.
useGrouping: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig, 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" anderweitig.
notation: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig. 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 Standardeinstellung, wo nötig. Es ist nur vorhanden, wenn notation "compact" ist. Es ist entweder "short" oder "long". Der Standard ist "short".
signDisplay: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig. 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 Standardeinstellung, wo nötig. 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 Standardeinstellung, wo nötig. 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 Standardeinstellung, wo nötig. Es ist entweder "auto", "morePrecision", oder "lessPrecision". Der Standard ist "auto".
trailingZeroDisplay: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardeinstellung, wo nötig. 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