Intl.NumberFormat.prototype.resolvedOptions()

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 hat die folgenden Eigenschaften, in der Reihenfolge, in der sie aufgelistet sind:

locale

Das BCP 47 Sprach-Tag für die tatsächlich verwendete Lokalisierung, bestimmt durch den Lokalisierungsverhandlungsprozess. Nur der nu Unicode-Erweiterungsschlüssel, falls angefordert, kann in der Ausgabe enthalten sein.

numberingSystem

Der in dem options Argument angegebene Wert für diese Eigenschaft, oder unter Verwendung des Unicode-Erweiterungsschlüssels "nu", wobei erforderlichenfalls Standardwerte ergänzt werden. Es ist ein unterstütztes Ziffernsystem für diese Lokalisierung. Der Standard ist lokalisierungsabhängig.

style

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Es ist entweder "decimal", "percent", "currency", oder "unit". Der Standard ist "decimal".

currency Optional

Der in dem options Argument angegebene Wert für diese Eigenschaft. Er 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 in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Er ist nur vorhanden, wenn style "currency" ist. Es ist entweder "code", "symbol", "narrowSymbol", oder "name". Der Standard ist "symbol".

currencySign Optional

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Er ist nur vorhanden, wenn style "currency" ist. Es ist entweder "standard" oder "accounting". Der Standard ist "standard".

unit Optional

Der in dem options Argument angegebene Wert für diese Eigenschaft. Er ist nur vorhanden, wenn style "unit" ist. Es ist ein genehmigter Einheitsbezeichner aus der vollständigen CLDR-Liste. Es ist erforderlich, wenn style "unit" ist, daher gibt es keinen Standardwert.

unitDisplay Optional

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Er ist nur vorhanden, wenn style "unit" ist. Es ist entweder "short", "narrow", oder "long". Der Standard ist "short".

minimumIntegerDigits

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Es ist eine ganze Zahl zwischen 1 und 21. Der Standard ist 1.

minimumFractionDigits, maximumFractionDigits Optional

Der in dem options Argument angegebene Wert für diese Eigenschaften, wobei erforderlichenfalls Standardwerte ergänzt werden. Sie sind nur vorhanden, wenn nötig; siehe Ziffernoptionen. Es ist eine ganze Zahl zwischen 0 und 100.

minimumSignificantDigits, maximumSignificantDigits Optional

Der in dem options Argument angegebene Wert für diese Eigenschaften, wobei erforderlichenfalls Standardwerte ergänzt werden. Sie sind nur vorhanden, wenn nötig; siehe Ziffernoptionen. Es ist eine ganze Zahl zwischen 1 und 21.

useGrouping

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden, und einige Werte normalisiert werden. Es ist entweder "always", "auto", "min2", oder der boolesche Wert false. Der Standard ist "min2", wenn notation "compact" ist, und "auto" andernfalls.

notation

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Es ist entweder "standard", "scientific", "engineering", oder "compact". Der Standard ist "standard".

compactDisplay Optional

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Sie ist nur vorhanden, wenn notation "compact" ist. Es ist entweder "short" oder "long". Der Standard ist "short".

signDisplay

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Es ist entweder "auto", "always", "exceptZero", "negative", oder "never". Der Standard ist "auto".

roundingIncrement

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Es ist eine der folgenden Zahlen: 1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500, und 5000. Der Standard ist 1.

roundingMode

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Es ist eine der folgenden Optionen: "ceil", "floor", "expand", "trunc", "halfCeil", "halfFloor", "halfExpand", "halfTrunc", und "halfEven". Der Standard ist "halfExpand".

roundingPriority

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. Es ist entweder "auto", "morePrecision", oder "lessPrecision". Der Standard ist "auto".

trailingZeroDisplay

Der in dem options Argument angegebene Wert für diese Eigenschaft, wobei erforderlichenfalls Standardwerte ergänzt werden. 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

Browser-Kompatibilität

Siehe auch

• Intl.NumberFormat