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 Optionen widerspiegeln, die während der Initialisierung dieses NumberFormat
Objekts berechnet wurden.
Probieren Sie es aus
Syntax
resolvedOptions()
Parameter
Keine.
Rückgabewert
Ein neues Objekt mit Eigenschaften, die die Optionen widerspiegeln, die während der Initialisierung dieses NumberFormat
Objekts berechnet wurden. Das Objekt hat die folgenden Eigenschaften in der angegebenen Reihenfolge:
locale
-
Der BCP 47 Sprach-Tag für das tatsächlich verwendete Gebietsschema, bestimmt durch den Gebietsschema-Aushandlungsprozess. Nur der
nu
Unicode-Erweiterungsschlüssel, falls angefordert, kann in der Ausgabe enthalten sein. numberingSystem
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, oder unter Verwendung des Unicode-Erweiterungsschlüssels"nu"
, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist ein unterstütztes Nummerierungssystem für dieses Gebietsschema. Die Standardeinstellung ist abhängig vom Gebietsschema. style
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist entweder"decimal"
,"percent"
,"currency"
, oder"unit"
. Die Standardeinstellung ist"decimal"
. currency
Optional-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde. Es ist nur vorhanden, wennstyle
"currency"
ist. Es ist ein ISO 4217 Währungscode. Es ist erforderlich, wennstyle
"currency"
ist, daher gibt es keinen Standardwert. currencyDisplay
Optional-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist nur vorhanden, wennstyle
"currency"
ist. Es ist entweder"code"
,"symbol"
,"narrowSymbol"
, oder"name"
. Die Standardeinstellung ist"symbol"
. currencySign
Optional-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist nur vorhanden, wennstyle
"currency"
ist. Es ist entweder"standard"
oder"accounting"
. Die Standardeinstellung ist"standard"
. unit
Optional-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde. Es ist nur vorhanden, wennstyle
"unit"
ist. Es ist ein genehmigter Einheitsbezeichner aus der vollständigen CLDR-Liste. Es ist erforderlich, wennstyle
"unit"
ist, daher gibt es keinen Standardwert. unitDisplay
Optional-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist nur vorhanden, wennstyle
"unit"
ist. Es ist entweder"short"
,"narrow"
, oder"long"
. Die Standardeinstellung ist"short"
. minimumIntegerDigits
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist eine Ganzzahl zwischen1
und21
. Die Standardeinstellung ist1
. minimumFractionDigits
,maximumFractionDigits
Optional-
Der Wert, der für diese Eigenschaften im
options
Argument angegeben wurde, mit standardmäßig ausgefüllten Werten, falls erforderlich. Sie sind nur vorhanden, wenn nötig; siehe Digit-Optionen. Es ist eine Ganzzahl zwischen0
und100
. minimumSignificantDigits
,maximumSignificantDigits
Optional-
Der Wert, der für diese Eigenschaften im
options
Argument angegeben wurde, mit standardmäßig ausgefüllten Werten, falls erforderlich. Sie sind nur vorhanden, wenn nötig; siehe Digit-Optionen. Es ist eine Ganzzahl zwischen1
und21
. useGrouping
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich, und mit einigen normalisierten Werten. Es ist entweder"always"
,"auto"
,"min2"
, oder der boolesche Wertfalse
. Die Standardeinstellung ist"min2"
, wennnotation
"compact"
ist, sonst"auto"
. notation
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist entweder"standard"
,"scientific"
,"engineering"
, oder"compact"
. Die Standardeinstellung ist"standard"
. compactDisplay
Optional-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist nur vorhanden, wennnotation
"compact"
ist. Es ist entweder"short"
oder"long"
. Die Standardeinstellung ist"short"
. signDisplay
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist entweder"auto"
,"always"
,"exceptZero"
,"negative"
, oder"never"
. Die Standardeinstellung ist"auto"
. roundingIncrement
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es gehört zu1
,2
,5
,10
,20
,25
,50
,100
,200
,250
,500
,1000
,2000
,2500
, und5000
. Die Standardeinstellung ist1
. roundingMode
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es gehört zu"ceil"
,"floor"
,"expand"
,"trunc"
,"halfCeil"
,"halfFloor"
,"halfExpand"
,"halfTrunc"
, und"halfEven"
. Die Standardeinstellung ist"halfExpand"
. roundingPriority
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist entweder"auto"
,"morePrecision"
, oder"lessPrecision"
. Die Standardeinstellung ist"auto"
. trailingZeroDisplay
-
Der Wert, der für diese Eigenschaft im
options
Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist entweder"auto"
oder"stripIfInteger"
. Die Standardeinstellung 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 Internationalization API Specification # sec-intl.numberformat.prototype.resolvedoptions |
Browser-Kompatibilität
BCD tables only load in the browser