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 Methode resolvedOptions()
von Instanzen von 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
const region = new Intl.DateTimeFormat("zh-CN", { timeZone: "UTC" });
const options = region.resolvedOptions();
console.log(options.locale);
// Expected output: "zh-CN"
console.log(options.calendar);
// Expected output: "gregory"
console.log(options.numberingSystem);
// Expected output: "latn"
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 die folgenden Eigenschaften in der aufgeführten Reihenfolge:
locale
-
Der BCP 47-Sprach-Tag für das tatsächlich verwendete Gebietsschema, bestimmt durch den Locale-Verhandlungsprozess. Nur die
ca
,hc
undnu
Unicode-Erweiterungsschlüssel, falls angefordert, können in der Ausgabe enthalten sein. calendar
-
Der in dem
options
-Argument angegebene Wert für diese Eigenschaft oder unter Verwendung des Unicode-Erweiterungsschlüssels"ca"
, wobei der Standardwert nach Bedarf ausgefüllt wird. Es ist ein unterstützter Kalendertyp für dieses Gebietsschema. Der Standard ist gebietsschemaabhängig. numberingSystem
-
Der in dem
options
-Argument angegebene Wert für diese Eigenschaft oder unter Verwendung des Unicode-Erweiterungsschlüssels"nu"
, wobei der Standardwert nach Bedarf ausgefüllt wird. Es ist ein unterstütztes Nummerierungssystem für dieses Gebietsschema. Der Standard ist gebietsschemaabhängig. timeZone
-
Der in dem
options
-Argument angegebene Wert für diese Eigenschaft, wobei der Standardwert nach Bedarf ausgefüllt wird. Es ist ein IANA-Zeitzonenname. Der Standard ist die Standardzeitzone der Laufzeitumgebung.Hinweis: Die Standardisierung von
Temporal
erfordert, dass Browser den ursprünglich angegebenen Bezeichner verwenden, ohne eine Kanonisierung zu einem anderen Alias vorzunehmen. Siehe Zeitzonen und Offsets für mehr Informationen. hourCycle
Optional-
Der in dem
options
-Argument angegebene Wert für diese Eigenschaft oder unter Verwendung des Unicode-Erweiterungsschlüssels"hc"
, wobei der Standardwert nach Bedarf ausgefüllt wird. Wennhour12
in denoptions
angegeben wurde, überschreibt dieses anderehourCycle
-Einstellungen. Es ist nur vorhanden, wenn die aufgelösten Optionen auchhour
odertimeStyle
enthalten. Es ist entweder"h11"
,"h12"
,"h23"
oder"h24"
. Der Standard ist gebietsschemaabhängig, obwohl"h24"
niemals ein Standard ist. hour12
Optional-
Berechnet aus
hourCycle
. Es ist nur vorhanden, wenn die aufgelösten Optionen auchhour
odertimeStyle
enthalten. 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 Uhrzeitformatierung im ausgewählten Gebietsschema resultieren. Einige dieser Eigenschaften sind möglicherweise nicht vorhanden, was darauf hinweist, dass die entsprechenden Komponenten in der formatierten Ausgabe 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 in
options
angefordert wurden, verhindert der Konstruktor die Spezifizierung vondateStyle
undtimeStyle
, sodass die untenstehende Gruppe niemals vorhanden sein wird. dateStyle
,timeStyle
Optional-
Die in dem
options
-Argument angegebenen Werte für diese Eigenschaften. Sie sind entweder"full"
,"long"
,"medium"
,"short"
oder"none"
. Einige dieser Eigenschaften sind möglicherweise nicht vorhanden, was darauf hinweist, dass die entsprechenden Komponenten in der formatierten Ausgabe nicht dargestellt werden.Wenn diese Eigenschaften in
options
angefordert wurden, verhindert der Konstruktor die Spezifizierung individueller Datum- und Zeitkomponentenoptionen, sodass die obige Gruppe niemals vorhanden sein wird.Hinweis: Obwohl
dateStyle
undtimeStyle
Abkürzungen für einzelne Datum- und Zeitkomponentenstile sind, sind die genauen (gebietsschemaabhängigen) Komponentenstile, die sie auflösen, nicht in den aufgelösten 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 Datum- oder Zeitkomponentenstilen ungültig ist).
Beispiele
>Verwenden der Methode resolvedOptions
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"
Erhalten der Zeitzonen- und Gebietsschema-Präferenzen des Benutzers
Der Intl.DateTimeFormat
Konstruktor ohne Optionen verwendet die aktuellen Systemeinstellungen. Sie können resolvedOptions()
verwenden, um die aktuelle Zeitzone und den bevorzugten Kalender und das Nummerierungssystem des Gebietsschemas des Benutzers zu erhalten:
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® 2026 Internationalization API Specification> # sec-intl.datetimeformat.prototype.resolvedoptions> |
Browser-Kompatibilität
Loading…