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
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
undnu
, 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. Wennhour12
imoptions
-Argument angegeben wurde, überschreibt dies anderehourCycle
-Einstellungen. Es ist nur vorhanden, wenn die berechneten Optionen auchhour
odertimeStyle
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 auchhour
odertimeStyle
beinhalten. Es isttrue
, wennhourCycle
"h11"
oder"h12"
ist, undfalse
, wennhourCycle
"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
unddayPeriod
sind entweder"narrow"
,"short"
oder"long"
;year
,day
,hour
,minute
undsecond
sind entweder"numeric"
,"2-digit"
oder"narrow"
;month
ist entweder"numeric"
,"2-digit"
,"narrow"
,"short"
oder"long"
;fractionalSecondDigits
ist entweder1
,2
oder3
;timeZoneName
ist entweder"short"
,"long"
,"shortOffset"
,"longOffset"
,"shortGeneric"
oder"longGeneric"
.Wenn diese Eigenschaften im
options
-Argument angefordert wurden, verhindert der Konstruktor, dassdateStyle
undtimeStyle
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
undtimeStyle
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 vonresolvedOptions()
direkt an denIntl.DateTimeFormat()
-Konstruktor übergeben werden kann (da einoptions
-Objekt mit sowohldateStyle
odertimeStyle
als auch individuellen Datums- oder Zeitkomponentenstilen nicht gültig ist).
Beispiele
Verwendung der resolvedOptions-Methode
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:
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