Intl.DateTimeFormat.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 Instanzen des Intl.DateTimeFormat gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung dieses DateTimeFormat-Objekts berechneten Optionen widerspiegeln.

Probieren Sie es aus

Syntax

js
resolvedOptions()

Parameter

Keine.

Rückgabewert

Ein neues Objekt mit Eigenschaften, die die während der Initialisierung dieses DateTimeFormat-Objekts berechneten Optionen widerspiegeln. Das Objekt hat folgende Eigenschaften, in der Reihenfolge, in der sie aufgelistet sind:

locale

Das BCP 47-Sprachtag für die tatsächlich verwendete Sprache, bestimmt durch den Sprachverhandlungsprozess. Nur die Unicode-Erweiterungsschlüssel ca, hc und nu, falls angefordert, können im Ergebnis enthalten sein.

calendar

Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde oder unter Verwendung des Unicode-Erweiterungsschlüssels "ca", mit erforderlichen Standardeinstellungen. Es handelt sich um einen unterstützten Kalendertyp für diese Sprache. Der Standard ist sprachabhängig.

numberingSystem

Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde oder unter Verwendung des Unicode-Erweiterungsschlüssels "nu", mit erforderlichen Standardeinstellungen. Es handelt sich um ein unterstütztes Zahlsystem für diese Sprache. Der Standard ist sprachabhängig.

timeZone

Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde, mit erforderlichen Standardeinstellungen. Es handelt sich um einen IANA-Zeitzonennamen. Der Standard ist die Standardzeitzone der Laufzeitumgebung.

Hinweis: Die Standardisierung von Temporal erfordert, dass Browser denselben Bezeichner wie ursprünglich angegeben verwenden, ohne eine Kanonisierung zu einem anderen Alias vorzunehmen. Weitere Informationen finden Sie unter Zeitzonen und Offsets.

hourCycle Optional

Der Wert, der für diese Eigenschaft im options-Argument angegeben wurde oder unter Verwendung des Unicode-Erweiterungsschlüssels "hc", mit erforderlichen Standardeinstellungen. Wenn hour12 im options-Argument angegeben wurde, überschreibt dies andere hourCycle-Einstellungen. Es ist nur vorhanden, wenn die berechneten Optionen auch hour oder timeStyle beinhalten. Es ist entweder "h11", "h12", "h23" oder "h24". Der Standard ist sprachabhängig, obwohl "h24" niemals ein Standard ist.

hour12 Optional

Basierend auf hourCycle berechnet. Es ist nur vorhanden, wenn die berechneten Optionen auch hour oder timeStyle beinhalten. Es ist true, wenn hourCycle "h11" oder "h12" ist, und false, wenn hourCycle "h23" oder "h24" ist.

weekday, era, year, month, day, dayPeriod, hour, minute, second, fractionalSecondDigits, timeZoneName Optional

Die Werte, die aus dem Formatabgleich zwischen den entsprechenden Eigenschaften im options-Argument und den verfügbaren Kombinationen und Darstellungen für die Datums- und Zeitformatierung in der ausgewählten Sprache resultieren. Einige dieser Eigenschaften sind möglicherweise nicht vorhanden, was bedeutet, dass die entsprechenden Komponenten im formatierten Ergebnis nicht dargestellt werden. weekday, era und dayPeriod sind entweder "narrow", "short" oder "long"; year, day, hour, minute und second sind entweder "numeric", "2-digit" oder "narrow"; month ist entweder "numeric", "2-digit", "narrow", "short" oder "long"; fractionalSecondDigits ist entweder 1, 2 oder 3; timeZoneName ist entweder "short", "long", "shortOffset", "longOffset", "shortGeneric" oder "longGeneric".

Wenn diese Eigenschaften im options-Argument angefordert wurden, verhindert der Konstruktor, dass dateStyle und timeStyle angegeben werden, sodass die folgende Gruppe niemals vorhanden sein wird.

dateStyle, timeStyle Optional

Die Werte, die für diese Eigenschaften im options-Argument angegeben wurden. Sie sind entweder "full", "long", "medium", "short" oder "none". Einige dieser Eigenschaften sind möglicherweise nicht vorhanden, was bedeutet, dass die entsprechenden Komponenten im formatierten Ergebnis nicht dargestellt werden.

Wenn diese Eigenschaften im options-Argument angefordert wurden, verhindert der Konstruktor, dass individuelle Datums- und Zeitkomponentenoptionen angegeben werden, sodass die obige Gruppe niemals vorhanden sein wird.

Hinweis: Obwohl dateStyle und timeStyle Abkürzungen für individuelle Datums- und Zeitkomponentenstile sind, sind die genauen (sprachabhängigen) Komponentenstile, auf die sie sich auflösen, nicht in den berechneten Optionen enthalten. Dies stellt sicher, dass das Ergebnis von resolvedOptions() direkt an den Intl.DateTimeFormat()-Konstruktor übergeben werden kann (da ein options-Objekt mit sowohl dateStyle oder timeStyle als auch individuellen Datums- oder Zeitkomponentenstilen nicht gültig ist).

Beispiele

Verwendung der resolvedOptions-Methode

js
const germanFakeRegion = new Intl.DateTimeFormat("de-XX", { timeZone: "UTC" });
const usedOptions = germanFakeRegion.resolvedOptions();

usedOptions.locale; // "de" (because "de-XX" does not exist)
usedOptions.calendar; // "gregory"
usedOptions.numberingSystem; // "latn"
usedOptions.timeZone; // "UTC"
usedOptions.month; // "numeric"

Abrufen der Zeitzonen- und Sprachpräferenzen des Benutzers

Der Intl.DateTimeFormat-Konstruktor ohne Optionen verwendet die aktuellen Systemeinstellungen. Sie können resolvedOptions() verwenden, um die aktuelle Zeitzone des Benutzers und das bevorzugte Kalender- und Zahlsystem der Sprache zu ermitteln:

js
const systemOptions = new Intl.DateTimeFormat().resolvedOptions();
systemOptions.timeZone; // e.g., "Europe/Brussels" or "Asia/Riyadh"
systemOptions.calendar; // e.g., "gregory" or "islamic-umalqura"
systemOptions.numberingSystem; // e.g., "latn" or "arab"
systemOptions.locale; // e.g., "nl-BE" or "ar-SA"

Spezifikationen

Specification
ECMAScript Internationalization API Specification
# sec-intl.datetimeformat.prototype.resolvedoptions

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch