CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — Datum und Uhrzeit lokalisiert formatieren
Mit `formatter.format()` zeigst du Datum und Uhrzeit passend zu einer Sprachregion und Zeitzone an. Das Ergebnis ist Anzeigetext und kein Format zur Datenspeicherung.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.format();
const format = formatter.format;
format(date);Rufe formatter.format(...) auf einer Instanz von Intl.DateTimeFormat auf, nicht auf dem Konstruktor. Erzeuge den Formatierer mit new Intl.DateTimeFormat(locales, options), um Sprachregion, Zeitzone und die anzuzeigenden Felder festzulegen. Der Aufruf liefert eine Zeichenkette und ändert das Date-Objekt nicht. Ohne locales oder timeZone verwendet der Formatierer den jeweiligen Standardwert der Laufzeitumgebung.
In ECMA-402 (2024) übergibst du ein Date-Objekt oder einen numerischen Zeitstempel in Millisekunden seit der Unix-Epoche, nicht in Sekunden. Ohne Argument oder mit undefined wird der aktuelle Zeitpunkt beim Aufruf formatiert. format() parst keine Datumszeichenketten: Wandle den Text zuerst in ein gültiges Date-Objekt oder einen Zeitstempel um. Ein ungültiges Date, NaN, Unendlichkeit oder ein Zeitstempel außerhalb des Date-Wertebereichs löst einen RangeError aus.
Intl.DateTimeFormat.prototype.format ist eine Eigenschaft mit Getter. Das Lesen von formatter.format liefert dieselbe an die Instanz gebundene Funktion. Du kannst sie daher direkt als Callback übergeben, etwa mit dates.map(formatter.format), ohne bind() aufzurufen.
Laufzeitumgebungen mit Temporal-Integration können auch Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth oder Temporal.PlainMonthDay formatieren, wenn der Typ zu den Einstellungen des Formatierers passt. Temporal.ZonedDateTime löst einen TypeError aus. Verwende Temporal.ZonedDateTime.prototype.toLocaleString(), um den Wert in seiner eigenen Zeitzone zu formatieren.
Selbst bei gleichen Einstellungen kann sich die Ausgabe zwischen Laufzeitumgebungen unterscheiden, etwa bei Leerzeichen, Satzzeichen und Steuerzeichen für die Schreibrichtung. Vergleiche sie nicht mit fest vorgegebenem Text und verwende sie nicht als Datenaustauschformat.
Beispiele
const formatter = new Intl.DateTimeFormat("en-GB", {
year: "numeric",
month: "long",
day: "numeric",
timeZone: "UTC",
});
const date = new Date("2024-06-15T00:00:00Z");
const format = formatter.format;
const text = formatter.format(date);
console.log(typeof text);
console.log(text === format(date.getTime()));Ergebnis
string true
Das Beispiel legt den Zeitpunkt, die Sprachregion und UTC als Zeitzone fest. Es prüft den Ergebnistyp und ob die separat aufgerufene Funktion einen Zeitstempel genauso formatiert wie der Instanzaufruf mit dem entsprechenden `Date`, ohne den genauen Text vorauszusetzen.
Zugehörige Lektionen
- JavaScript · Lektion 15 · Grundlagen · Version: 4