Intl.NumberFormat.prototype.resolvedOptions()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die Methode resolvedOptions() von Intl.NumberFormat-Instanzen gibt ein neues Objekt zurück, dessen Eigenschaften die bei der Initialisierung dieses NumberFormat-Objekts ermittelten 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, dessen Eigenschaften die anhand der an den Konstruktor Intl.NumberFormat() übergebenen Argumente ermittelten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften in der hier aufgeführten Reihenfolge:
locale-
Der BCP-47-Sprach-Tag für das tatsächlich verwendete Gebietsschema, das durch den Prozess der Aushandlung des Gebietsschemas bestimmt wurde. In der Ausgabe darf nur der Unicode-Erweiterungsschlüssel
nuenthalten sein, sofern er angefordert wurde. numberingSystem-
Der für diese Eigenschaft im Argument
optionsoder über den Unicode-Erweiterungsschlüssel"nu"angegebene Wert, gegebenenfalls ergänzt um den Standardwert. Es handelt sich um ein für dieses Gebietsschema unterstütztes Zahlensystem. Der Standardwert hängt vom Gebietsschema ab. style-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist entweder"decimal","percent","currency"oder"unit". Der Standardwert ist"decimal". currencyOptional-
Der für diese Eigenschaft im Argument
optionsangegebene Wert. Diese Eigenschaft ist nur vorhanden, wennstyleden Wert"currency"hat. Der Wert ist ein ISO-4217-Währungscode; sieheIntl.supportedValuesOf(). Wennstyleden Wert"currency"hat, ist die Angabe erforderlich; daher gibt es keinen Standardwert. currencyDisplayOptional-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Diese Eigenschaft ist nur vorhanden, wennstyleden Wert"currency"hat. Der Wert ist entweder"code","symbol","narrowSymbol"oder"name". Der Standardwert ist"symbol". currencySignOptional-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Diese Eigenschaft ist nur vorhanden, wennstyleden Wert"currency"hat. Der Wert ist entweder"standard"oder"accounting". Der Standardwert ist"standard". unitOptional-
Der für diese Eigenschaft im Argument
optionsangegebene Wert. Diese Eigenschaft ist nur vorhanden, wennstyleden Wert"unit"hat. Der Wert ist ein zulässiger Einheitenbezeichner aus der vollständigen CLDR-Liste. Wennstyleden Wert"unit"hat, ist die Angabe erforderlich; daher gibt es keinen Standardwert. unitDisplayOptional-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Diese Eigenschaft ist nur vorhanden, wennstyleden Wert"unit"hat. Der Wert ist entweder"short","narrow"oder"long". Der Standardwert ist"short". minimumIntegerDigits-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist eine Ganzzahl zwischen1und21. Der Standardwert ist1. minimumFractionDigits,maximumFractionDigitsOptional-
Die für diese Eigenschaften im Argument
optionsangegebenen Werte, gegebenenfalls ergänzt um Standardwerte. Sie sind nur vorhanden, wenn sie benötigt werden; siehe Optionen für Ziffern. Die Werte sind Ganzzahlen zwischen0und100. minimumSignificantDigits,maximumSignificantDigitsOptional-
Die für diese Eigenschaften im Argument
optionsangegebenen Werte, gegebenenfalls ergänzt um Standardwerte. Sie sind nur vorhanden, wenn sie benötigt werden; siehe Optionen für Ziffern. Die Werte sind Ganzzahlen zwischen1und21. useGrouping-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert und mit bestimmten Werten in normalisierter Form. Der Wert ist entweder"always","auto","min2"oder der boolesche Wertfalse. Der Standardwert ist"min2", wennnotationden Wert"compact"hat, andernfalls"auto". notation-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist entweder"standard","scientific","engineering"oder"compact". Der Standardwert ist"standard". compactDisplayOptional-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Diese Eigenschaft ist nur vorhanden, wennnotationden Wert"compact"hat. Der Wert ist entweder"short"oder"long". Der Standardwert ist"short". signDisplay-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist entweder"auto","always","exceptZero","negative"oder"never". Der Standardwert ist"auto". roundingIncrement-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist einer der folgenden:1,2,5,10,20,25,50,100,200,250,500,1000,2000,2500und5000. Der Standardwert ist1. roundingMode-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist einer der folgenden:"ceil","floor","expand","trunc","halfCeil","halfFloor","halfExpand","halfTrunc"und"halfEven". Der Standardwert ist"halfExpand". roundingPriority-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist entweder"auto","morePrecision"oder"lessPrecision". Der Standardwert ist"auto". trailingZeroDisplay-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Der Wert ist entweder"auto"oder"stripIfInteger". Der Standardwert 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
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-intl.numberformat.prototype.resolvedoptions> |