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, wennstyle
"currency"
ist. Es ist ein ISO 4217-Währungscode; sieheIntl.supportedValuesOf()
. Sie ist erforderlich, wennstyle
"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, wennstyle
"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, wennstyle
"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, wennstyle
"unit"
ist. Es ist ein sanctioned unit identifier aus der full CLDR list. Sie ist erforderlich, wennstyle
"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, wennstyle
"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 zwischen1
und21
. Der Standard ist1
. 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 zwischen0
und100
. 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 zwischen1
und21
. 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 Booleanfalse
. Der Standard ist"min2"
, wennnotation
"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, wennnotation
"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 von1
,2
,5
,10
,20
,25
,50
,100
,200
,250
,500
,1000
,2000
,2500
und5000
. Der Standard ist1
. 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 |