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, wenn style "currency" ist. Es ist ein ISO 4217 Währungscode. Es ist erforderlich, wenn style "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, wenn style "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, wenn style "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, 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 Wert, der für diese Eigenschaft im options Argument angegeben wurde, mit standardmäßig ausgefülltem Wert, falls erforderlich. Es ist nur vorhanden, wenn style "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 zwischen 1 und 21. Die Standardeinstellung ist 1.
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 zwischen 0 und 100.
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 zwischen 1 und 21.
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 Wert false. Die Standardeinstellung ist "min2", wenn notation "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, wenn notation "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 zu 1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500, und 5000. Die Standardeinstellung ist 1.
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

Siehe auch

Intl.NumberFormat