WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Intl.DateTimeFormat — lokalisierte Datums- und Zeitformatierung

Intl.DateTimeFormat formatiert Datum und Uhrzeit nach Gebietsschema-Konventionen und für eine ausgewählte Zeitzone. Lerne format(), formatToParts(), resolvedOptions() und den Unterschied zwischen timeZone und hourCycle kennen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();

Intl.DateTimeFormat gehört zum Internationalisierungsstandard ECMA-402, nicht zur DOM-API. Erstelle einen Formatter mit new Intl.DateTimeFormat(locales, options) und verwende ihn wiederholt. Ein Gebietsschema legt Darstellungskonventionen fest; es wählt nicht automatisch die Zeitzone des entsprechenden Landes aus.

Die Bezeichnungen Intl.DateTimeFormat.format und Intl.DateTimeFormat.formatToParts meinen hier Instanzoperationen, keine statischen Methoden des Konstruktors. formatter.format(date) gibt Text zurück; die Eigenschaft format ist ein Accessor, der eine gebundene Funktion bereitstellt. formatter.formatToParts(date) gibt geordnete { type, value }-Objekte zurück, einschließlich literal-Teilen. Durch Verknüpfen aller value-Werte wird format(date) rekonstruiert. Zerlege lokalisierten Text nicht anhand von Trennzeichen.

timeZone, etwa UTC oder Europe/Warsaw, wählt die Zone für die Anzeige desselben Zeitpunkts aus, ohne das Date-Objekt zu ändern. Wird die Option weggelassen, gilt die Zeitzone der Umgebung. hourCycle legt den Stundenbereich fest: h11 bedeutet 0–11, h12 1–12, h23 0–23 und h24 1–24. Die Option ist beim Formatieren von Stunden relevant; wenn angegeben, hat hour12 Vorrang.

Intl.DateTimeFormat.prototype.resolvedOptions, aufgerufen als formatter.resolvedOptions(), zeigt die tatsächlich ausgewählten Einstellungen, darunter locale, timeZone und, wenn das Format Stunden enthält, hourCycle. Gebietsschemadaten können sich zwischen Umgebungen unterscheiden; gehe daher nicht von identischer Zeichensetzung oder Abständen aus. Der Standard ist keine Browser-Kompatibilitätstabelle: Prüfe die benötigten Methoden und Optionen in den Zielumgebungen; Node 24 belegt keine Browserunterstützung.

Beispiele

const formatter = new Intl.DateTimeFormat('en-GB', {
  timeZone: 'UTC',
  numberingSystem: 'latn',
  hour: '2-digit',
  minute: '2-digit',
  hourCycle: 'h23'
});
const date = new Date('2024-01-02T00:05:00Z');
const parts = formatter.formatToParts(date);
const field = type => parts.find(part => part.type === type).value;
console.log(`${field('hour')}:${field('minute')}`);
console.log(parts.map(part => part.value).join('') === formatter.format(date));
console.log(formatter.resolvedOptions().hourCycle);

Ergebnis

00:05
true
h23

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen