WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Intl.DateTimeFormat: wirksame Optionen abfragen

Mit `resolvedOptions()` siehst du, welche Einstellungen eine Instanz tatsächlich zur Datums- und Zeitformatierung verwendet, statt sie aus den Konstruktorargumenten abzuleiten.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

formatter.resolvedOptions()

Intl.DateTimeFormat.prototype.resolvedOptions ist eine Instanzmethode ohne Argumente. Jeder Aufruf liefert ein neues gewöhnliches Objekt mit den Einstellungen, die beim Erstellen des Formatierers festgelegt wurden. Änderungen am Ergebnis ändern den Formatierer nicht. Anders als format() nimmt die Methode kein Datum entgegen und gibt keinen formatierten Text aus. Ein ungebundener Aufruf oder ein Aufruf mit einem ungeeigneten this wie {} löst einen TypeError aus.

Das Ergebnis enthält locale (das tatsächlich gewählte BCP-47-Sprach-Tag), calendar, numberingSystem und timeZone. Es ist keine Kopie der Konstruktoreingaben: Die Aushandlung der Locale und Standardwerte können das Ergebnis beeinflussen. Ohne explizites timeZone übernimmt der Formatierer beim Erstellen die Standardzeitzone der Laufzeitumgebung. Eine Zeitzonenkennung kann normalisiert werden; sie muss nicht exakt der Eingabe entsprechen.

Ohne dateStyle und timeStyle spiegeln Eigenschaften wie year, month und hour das ausgewählte Muster wider; ungenutzte Bestandteile fehlen. Mit dateStyle oder timeStyle meldet das Ergebnis die angegebenen Stile, ohne sie in einzelne Bestandteile aufzulösen. Ein Stil zusammen mit einer expliziten Komponentenoption wie hour löst bereits im Konstruktor einen TypeError aus.

Enthält das Muster eine Stunde, liefert das Ergebnis hourCycle und das daraus abgeleitete hour12, auch wenn wegen timeStyle die Eigenschaft hour fehlt. hour12 ist für h11 und h12 gleich true, für h23 und h24 gleich false. Ohne Stunde fehlen beide Eigenschaften. Bei der Wahl des Zyklus hat die Option hour12 Vorrang vor hourCycle und der Unicode-Erweiterung hc.

Das Ergebnis hilft, Unterschiede zwischen Laufzeitumgebungen zu untersuchen. Unterstützte Optionen und Locale-Daten können variieren; gleiche wirksame Einstellungen garantieren keinen identischen formatierten Text.

Beispiele

const formatter = new Intl.DateTimeFormat("en-GB", {
  timeZone: "UTC",
  timeStyle: "short",
  hour12: false,
});
const options = formatter.resolvedOptions();

console.log(options.timeZone);
console.log(options.timeStyle);
console.log(options.hour12);
console.log(Object.hasOwn(options, "hour"));

options.timeZone = "Asia/Tokyo";
console.log(formatter.resolvedOptions().timeZone);

Ergebnis

UTC
short
false
false
UTC

Der Code gibt nacheinander `UTC`, `short`, `false`, `false` und `UTC` aus. Das erste `false` steht für das 24-Stunden-Format, das zweite dafür, dass `hour` keine eigene Eigenschaft ist. Die Zuweisung von `Asia/Tokyo` ändert nur das zurückgegebene Objekt.

Zugehörige Lektionen

  • JavaScript · Lektion 25 · Fortgeschritten · Version: 4

Quellen