mitmario.dev

Datum und Zeit

JavaScript Im Browser 4 Min Lesezeit 3 BeispieleLektion 1 von 6

Zwischen dem 3. und dem 13. August liegen zehn Tage, und auf einer deutschen Seite soll der erste davon als „3. August 2026“ stehen. Beides kann ein Date, wenn du weißt, wo es zählt wie ein Mensch und wo nicht. Im Kern ist es eine einzige Zahl, die Millisekunden seit dem 1. Januar 1970. Alles andere sind Wege, diese Zahl zu bauen und wieder auszugeben.

Vier Wege, eines zu bauen

Vier Wege, ein Datum zu bauen
// 1. Jetzt.
const jetzt = new Date();
console.log("Jahr:", jetzt.getFullYear());

// 2. Aus einem ISO-Text. Der zuverlässigste Weg.
const ausText = new Date("2026-08-03");
console.log("Aus Text:", ausText.toISOString());

// 3. Aus Einzelteilen. Und hier lauert die Falle:
// der Monat zählt ab null, der Tag ab eins.
const ausTeilen = new Date(2026, 7, 3);
console.log("Aus Teilen:", ausTeilen.getFullYear(), ausTeilen.getMonth(), ausTeilen.getDate());
console.log("Die 7 ist der August:", ausTeilen.toDateString());

// 4. Aus Millisekunden seit dem 1. Januar 1970.
const ausZahl = new Date(0);
console.log("Der Nullpunkt:", ausZahl.toISOString());

// Ein beliebter Trick: Tag 0 des nächsten Monats ist
// der letzte Tag des laufenden.
console.log("Letzter Tag im Februar 2024:", new Date(2024, 2, 0).getDate());
console.log("Letzter Tag im Februar 2026:", new Date(2026, 2, 0).getDate());
  • new Date() liefert den Moment, in dem die Zeile läuft.
  • new Date("2026-08-03") liest einen ISO-Text, also ein Datum in der internationalen Schreibweise Jahr, Monat, Tag. Das ist der zuverlässigste Weg. Formate wie 03.08.2026 gehören ausdrücklich nicht dazu, denn was der Browser damit macht, ist nicht festgelegt.
  • new Date(2026, 7, 3) baut aus Einzelteilen, und hier steckt die Falle dieser Lektion.
  • new Date(0) nimmt Millisekunden.

Tippst du new Date("03.08.2026").toString() in die Eingabezeile der Console, fängt die Antwort mit Sun Mar 08 2026 an, dahinter steht die eigene Zeitzone. Aus dem 3. August ist der 8. März geworden. Der Browser nimmt die erste Zahl für den Monat, so wie man es in den USA schreibt. Es gibt keinen Fehler und keine Warnung, nur ein Datum fünf Monate daneben. Deshalb steht das Jahr vorn, wenn ein Datum irgendwo gespeichert oder verschickt wird.

Der Monat zählt ab null

Die Sieben in new Date(2026, 7, 3) ist der August, nicht der Juli.

Der Monat zählt ab null, der Tag ab eins, und das Jahr ist das Jahr. Einen guten Grund dafür gibt es nicht. Es ist ein Überbleibsel aus dem Jahr 1995, und für eine Änderung ist es zu spät. Am besten merkt man sich genau diesen einen Satz. getMonth() gibt dieselbe Zahl zurück, also kommt auch beim Lesen eine Eins dazu, wenn ein Mensch sie sehen soll.

Praktisch wird das an einer Stelle. Tag 0 eines Monats ist der letzte Tag des Monats davor. new Date(2024, 2, 0) ist also der 29. Februar 2024, und so bekommst du die Länge eines Monats, ohne Schaltjahre selbst zu rechnen.

Rechnen über getTime

Rechnen über getTime
const TAG = 24 * 60 * 60 * 1000;

const start = new Date("2026-08-03");
const ende = new Date("2026-08-13");

// getTime liefert Millisekunden seit 1970.
console.log("Start als Zahl:", start.getTime());

const tage = (ende.getTime() - start.getTime()) / TAG;
console.log("Tage dazwischen:", tage);

// Und so verschiebt man ein Datum.
const inZehnTagen = new Date(start.getTime() + 10 * TAG);
console.log("Zehn Tage später:", inZehnTagen.toISOString().slice(0, 10));

// Mit den Einzelteilen müsste man wissen, wie lang jeder
// Monat ist, und Jahre sind manchmal auch verschieden lang.
// getUTCDate und setUTCDate, nicht getDate und setDate: ein
// ISO-Datum ohne Uhrzeit liegt auf UTC, und toISOString unten
// liest ebenfalls UTC. Wer hier mischt, landet über die
// Zeitumstellung einen Tag zu früh, in Berlin genauso wie
// in New York.
const naiv = new Date("2026-08-03");
naiv.setUTCDate(naiv.getUTCDate() + 30);
console.log("30 Tage weiter ist der:", naiv.toISOString().slice(0, 10));
console.log("Ein Monat weiter wäre etwas anderes gewesen.");

Für Differenzen wird mit der Zahl gerechnet und nicht mit den Einzelteilen. getTime() liefert sie. Zwei davon voneinander abgezogen ergeben Millisekunden, und geteilt durch die Millisekunden eines Tages ergeben sie Tage.

Mit getDate() und getMonth() müsste die Rechnung wissen, dass Monate verschieden lang sind und der Februar manchmal auch. Die Rechnung mit Millisekunden muss das nicht. Das gilt, solange beide Daten auf UTC liegen, der Weltzeit ohne Sommerzeit, und bei einem ISO-Datum ohne Uhrzeit ist das so.

In Ortszeit hat sie einen eigenen Haken. Die Umstellung auf Sommerzeit macht zwei Tage im Jahr 23 und 25 Stunden lang. (new Date(2026, 2, 30) - new Date(2026, 2, 28)) / TAG ergibt in Berlin deshalb 1.958… statt 2. Im zweiten Beispiel stehen aus diesem Grund getUTCDate und setUTCDate statt getDate und setDate, und toISOString gibt das Datum ebenfalls in UTC aus.

Ausgeben nur mit Intl

Ausgeben mit Intl
const datum = new Date("2026-08-03");

// Der Handweg. Funktioniert und macht viel Arbeit.
const selbst = `${datum.getUTCDate()}.${datum.getUTCMonth() + 1}.${datum.getUTCFullYear()}`;
console.log("Von Hand:", selbst);

// Mit Intl, dem Gegenstück zu NumberFormat aus Lektion 8.4.
const lang = new Intl.DateTimeFormat("de-DE", {
  day: "numeric",
  month: "long",
  year: "numeric",
  timeZone: "UTC",
});

const kurz = new Intl.DateTimeFormat("de-DE", {
  day: "2-digit",
  month: "2-digit",
  year: "numeric",
  timeZone: "UTC",
});

console.log("Lang:", lang.format(datum));
console.log("Kurz:", kurz.format(datum));
console.log("Englisch:", new Intl.DateTimeFormat("en-US", { dateStyle: "long", timeZone: "UTC" }).format(datum));

// Ohne timeZone rechnet der Browser in die Zeitzone des
// Besuchers um. Westlich von hier wäre das der Vortag.
console.log("Ohne timeZone:", new Intl.DateTimeFormat("de-DE").format(datum));

Zum Anzeigen gibt es Intl.DateTimeFormat, das Gegenstück zu Intl.NumberFormat aus Lektion 8.4. Es bekommt die Sprache und die Teile, die zu sehen sein sollen. day: "numeric" schreibt den Tag ohne führende Null, "2-digit" mit, und month: "long" den Monatsnamen. Den Rest macht der Browser. Die Reihenfolge der Bestandteile, die Trennzeichen und die Monatsnamen sind von Sprache zu Sprache verschieden, und nichts davon will man selbst pflegen.

Wer es doch von Hand baut, schreibt drei Zeilen, die für Deutsch stimmen. Sobald jemand nach einer englischen Fassung fragt, stehen dieselben drei Zeilen an neun Stellen im Projekt.

Zeitzonen

Ein Date kennt keine Zeitzone. Es ist ein Zeitpunkt, und die Zeitzone entsteht erst beim Ausgeben.

new Date("2026-08-03") ohne Uhrzeit wird als Mitternacht UTC gelesen. Zeigst du das danach in der eigenen Zeitzone an, sieht man westlich von Greenwich den Vortag. Deshalb steht in den Beispielen dieser Lektion überall timeZone: "UTC".

In welcher Zeitzone dein Rechner sitzt, verrät Intl.DateTimeFormat().resolvedOptions().timeZone in der Eingabezeile der Console. In Berlin steht dort Europe/Berlin, und das erklärt die letzte Zeile des dritten Beispiels. Mitternacht UTC ist dort zwei Uhr morgens, also derselbe Tag, und mit und ohne timeZone steht beide Male 3.8.2026 da. Den Unterschied, vor dem der Absatz oben warnt, siehst du von hier aus also gar nicht, und treffen würde er den Besucher in New York.

Ich speichere Zeitpunkte immer als ISO-Text oder als Zahl und entscheide erst beim Anzeigen, in welcher Zeitzone sie stehen.

Wo Date nicht reicht

Alles, was über Differenzen und Formatieren hinausgeht, wird mit dieser API unangenehm. Einen Monat dazurechnen, Wochen zählen, Zeitzonen umrechnen, Wiederholungen berechnen. Dafür gibt es Bibliotheken, und schon dass es sie gibt, heißt, dass Date an dieser Stelle nicht genügt.

Das ändert sich gerade. Eine neue eingebaute API namens Temporal löst diese Probleme. Firefox hat sie seit Version 139, Chrome seit 144, Safari noch nicht. Hast du wieder mit Datumsarithmetik zu tun, lohnt sich dort der erste Blick.

In der Aufgabe rechnen und formatieren vier kleine Funktionen mit Daten, auch über die Zeitumstellung hinweg.

Zum Mitnehmen

Gerechnet wird mit getTime, ausgegeben mit Intl.DateTimeFormat und einer festen Zeitzone. Und in new Date(2026, 7, 3) ist die Sieben der August, denn der Monat zählt ab null.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe im Editor, direkt im Browser geprüft

    Öffnet sich mit dem Basis Konto.