Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

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 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 und nu 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. Wenn hour12 in den options angegeben wurde, überschreibt dieses andere hourCycle-Einstellungen. Es ist nur vorhanden, wenn die aufgelösten Optionen auch hour oder timeStyle 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 auch hour oder timeStyle enthalten. 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 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 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 in options angefordert wurden, verhindert der Konstruktor die Spezifizierung von dateStyle und timeStyle, 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 und timeStyle 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 von resolvedOptions() direkt an den Intl.DateTimeFormat() Konstruktor übergeben werden kann (da ein options-Objekt mit sowohl dateStyle oder timeStyle als auch individuellen Datum- oder Zeitkomponentenstilen ungültig ist).

Beispiele

Verwenden der Methode resolvedOptions

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"

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:

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® 2026 Internationalization API Specification
# sec-intl.datetimeformat.prototype.resolvedoptions

Browser-Kompatibilität

Siehe auch