WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Datum und Uhrzeit

Ein Date-Objekt stellt einen Zeitpunkt als Millisekunden seit Beginn des Jahres 1970 in UTC dar. Unterscheiden Sie zwischen einem Zeitpunkt, einer lokalen Kalenderdarstellung und einer Zeitdauer, um Fehler im Zusammenhang mit Zeitzonen zu vermeiden.

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

new Date(milliseconds)
new Date("YYYY-MM-DDTHH:mm:ss.sssZ")
date.getTime()
date.toISOString()

Date speichert einen Zeitpunkt als ganzzahlige Anzahl von Millisekunden seit 1970-01-01T00:00:00.000Z; negative Werte stehen für frühere Zeitpunkte. Eine Zeitzone wird nicht gespeichert. getTime() gibt diese Zahl zurück, während toISOString() den Zeitpunkt in UTC mit einem abschließenden Z darstellt.

Ein Zeitpunkt, ein lokales Datum mit Uhrzeit und eine Zeitdauer sind unterschiedliche Begriffe. Lokale Methoden interpretieren einen Zeitpunkt in der Zeitzone der Umgebung, UTC-Methoden verwenden UTC. Durch Zeitumstellungen kann ein lokaler Tag von 24 Stunden abweichen. Das Addieren von 86400000 Millisekunden bedeutet daher 24 Stunden, aber nicht unbedingt dieselbe lokale Uhrzeit am nächsten Tag.

Verwenden Sie beim Einlesen von Text das Standardformat mit einem ausdrücklichen Z oder Offset. Ohne Offset wird YYYY-MM-DD als UTC interpretiert, ein Datum mit Uhrzeit dagegen als lokale Zeit. Andere Formate können von der Implementierung abhängen. Ein ungültiges Date hat den Zeitwert NaN; prüfen Sie dies mit Number.isNaN(date.getTime()). Der Aufruf von toISOString() für ein solches Objekt löst einen RangeError aus.

Das Beispiel addiert 90 Minuten zu einem festen Zeitpunkt und berechnet die Differenz in Sekunden. Die gezeigten Operationen gehören zu ECMAScript, nicht zu den Browser-Web-APIs.

Beispiele

const start = new Date("2024-01-01T00:00:00.000Z");
const end = new Date(start.getTime() + 90 * 60 * 1000);
console.log(end.toISOString());
console.log((end.getTime() - start.getTime()) / 1000);

Ergebnis

2024-01-01T01:30:00.000Z
5400

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