WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Intl.DateTimeFormat: Datumsbestandteile mit formatToParts() erhalten

Rufe die Bestandteile eines lokalisierten Datums oder einer Uhrzeit ab, um etwa den Monat hervorzuheben, ohne den Text an Trennzeichen aufzuteilen oder eine Feldreihenfolge vorauszusetzen.

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

Syntax

formatter.formatToParts()
formatter.formatToParts(date)

formatToParts() ist eine Instanzmethode von Intl.DateTimeFormat, die auf Intl.DateTimeFormat.prototype definiert ist, keine statische Methode des Konstruktors. Rufe sie als formatter.formatToParts(date) auf. Anders als format() ist sie nicht automatisch an die Instanz gebunden: Wird die separat gespeicherte Funktion ohne das richtige this aufgerufen, entsteht ein TypeError.

Übergib ein Date oder einen Zeitstempel in Millisekunden seit der Unix-Epoche, nicht in Sekunden. Ohne Argument oder mit undefined wird die aktuelle Zeit aus Date.now() verwendet. Ein ungültiges Date oder ein Zeitstempel außerhalb des gültigen Bereichs führt zu einem RangeError. Die Methode formatiert Werte und interpretiert keinen Datumstext. Laufzeitumgebungen mit Temporal-Integration können auch einige Temporal.Plain*-Typen akzeptieren; ein direkt übergebenes Temporal.ZonedDateTime führt zu einem TypeError.

Das Ergebnis ist ein Array von { type, value }-Objekten in Anzeigereihenfolge; beide Eigenschaften sind Zeichenketten. Ein type wie month, day oder year bezeichnet ein Feld. literal steht für Text aus dem Muster, etwa ein Komma, Leerzeichen oder Wort. In Kalendern mit benannten Jahren kann relatedYear (das entsprechende gregorianische Jahr) anstelle von year erscheinen; das Muster kann außerdem yearName (den Namen des Jahres) enthalten.

Wähle Bestandteile nach type aus, nicht nach Array-Index. Um das Ergebnis von format() für denselben Formatierer und dasselbe Datum nachzubilden, füge alle value-Zeichenketten ohne Trennzeichen zusammen, auch die zu literal. Die Spracheinstellung und Optionen wie Kalender und Zeitzone beeinflussen das Ergebnis. Schreibweise und Zeichensetzung können sich selbst bei gleicher Spracheinstellung je nach Laufzeitumgebung unterscheiden. Verwende das Ergebnis nicht als Datenaustauschformat.

Beispiele

const formatter = new Intl.DateTimeFormat("en-US", {
  timeZone: "UTC",
  year: "numeric",
  month: "long",
  day: "numeric",
});
const date = new Date("2024-07-09T12: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 Datum, Spracheinstellung und die Zeitzone UTC fest. Das erste `true` bestätigt einen `month`-Bestandteil, das zweite die Übereinstimmung der zusammengefügten Werte mit `format()`.

Zugehörige Lektionen

  • JavaScript · Lektion 15 · Grundlagen · Version: 4

Quellen