CKTIS / JavaScript
Intl.DateTimeFormat.formatToParts(): Bestandteile von Datum und Uhrzeit
Rufe die Bestandteile eines lokalisierten Datums oder einer Uhrzeit ab, um einzelne Felder zu gestalten, ohne deren Reihenfolge oder Trennzeichen vorauszusetzen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
formatter.formatToParts()
formatter.formatToParts(date)Intl.DateTimeFormat.prototype.formatToParts ist eine Instanzmethode von Intl.DateTimeFormat. Statt einer einzelnen Zeichenkette wie format() liefert sie ein Array aus { type, value }-Objekten in Anzeigereihenfolge. Beide Eigenschaften sind Zeichenketten. Verbindest du alle value-Werte mit join(""), erhältst du für denselben Formatierer und dieselbe Eingabe das Ergebnis von format(). Anders als die von format gelieferte Funktion ist formatToParts nicht automatisch gebunden. Verwende als Callback date => formatter.formatToParts(date) oder nutze bind; ein ungeeignetes this löst TypeError aus.
Wähle Teile nach type aus, etwa month oder dayPeriod, nicht nach dem Arrayindex. Behalte literal-Teile bei: Sie können Leerzeichen, Satzzeichen oder Wörter enthalten. In manchen Kalendern erscheint statt year der Typ relatedYear (das entsprechende gregorianische Jahr), manchmal zusammen mit yearName (dem Jahresnamen). Behalte auch unbekannte Teile bei. Spracheinstellungen, Optionen und Laufzeitdaten können das Ergebnis beeinflussen. Verwende die Teile zur Anzeige, nicht zum Parsen oder Speichern. Füge Werte im Browser mit textContent als Text ein, nicht mit innerHTML.
Übergib gemäß ECMA-402 für ECMAScript 2024 ein Date-Objekt oder die Anzahl der Millisekunden seit der Unix-Epoche. Die Methode konvertiert das Argument in eine Zahl, statt Datumszeichenketten zu parsen. Ohne Argument oder mit undefined verwendet sie die aktuelle Zeit beim Aufruf. Ein ungültiges Date oder ein Zeitstempel außerhalb des gültigen Bereichs löst RangeError aus.
Laufzeitumgebungen mit Temporal-Integration akzeptieren auch Temporal.Instant und die für diese Methode spezifizierten Temporal.Plain*-Typen, mit typabhängigen Einschränkungen für Kalender und Formatierung. Prüfe die Unterstützung in deiner Zielumgebung. Ein direkt übergebenes Temporal.ZonedDateTime löst TypeError aus. Für Teile desselben Zeitpunkts in seiner Zeitzone übergib das Ergebnis von toInstant() und setze timeZone des Formatierers auf die Zeitzone dieses Objekts.
Beispiele
{
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone: "UTC",
calendar: "gregory",
year: "numeric",
month: "long",
day: "numeric",
});
const date = new Date("2024-07-05T12:00:00Z");
const parts = formatter.formatToParts(date);
console.log(parts.some(({ type }) => type === "month"));
console.log(parts.map(({ value }) => value).join("") === formatter.format(date));
}Ergebnis
true true
Das Beispiel legt Zeitpunkt, Spracheinstellung und die Zeitzone UTC fest. Das erste `true` bestätigt einen `month`-Teil. Das zweite bestätigt, dass die verbundenen Werte `format(date)` entsprechen, ohne bestimmte Trennzeichen vorauszusetzen.
Zugehörige Lektionen
- JavaScript · Lektion 25 · Fortgeschritten · Version: 4