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
- ECMAScript® 2027 Internationalization API Specification
- ECMAScript® 2024 Internationalization API Specification
- ECMAScript® 2026 Internationalization API Specification
- Official reference — tc39.es: ecma402
- Official reference — tc39.es: ecma402
- Official reference — developer.mozilla.org: Intl / DateTimeFormat