WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Date.prototype.getTime: Epochenmillisekunden

getTime liefert den Zeitwert eines Date-Objekts als Millisekunden seit der Unix-Epoche, unabhängig von der Zeitzone.

Version: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

date.getTime()

date.getTime() liefert den internen Zeitwert als Number: Millisekunden seit 1970-01-01T00:00:00Z. Werte vor der Epoche sind negativ. Das Ergebnis ist unabhängig von der lokalen Zeitzone und entspricht date.valueOf(), daher eignet es sich zum Vergleichen, Sortieren und Klonen mit new Date(date.getTime()).

Bei einem ungültigen Date liefert die Methode NaN. Gültige Date-Werte sind ganze Millisekunden, durch TimeClip auf ±8.64e15 begrenzt. Die Methode hat keine Argumente, verändert das Objekt nicht und ignoriert zusätzliche Argumente.

Der Receiver muss internen Date-Zustand besitzen; Date.prototype.getTime.call({}) löst TypeError aus. Die Methode existiert seit ECMAScript 1.

Beispiele

const original = new Date("2024-01-01T00:00:00.123Z");
const timestamp = original.getTime();
const clone = new Date(timestamp);

console.log(timestamp);
console.log(clone.getTime() === original.getTime(), clone === original);
console.log(new Date(-1).getTime());
console.log(Number.isNaN(new Date(NaN).getTime()));

Ergebnis

1704067200123
true false
-1
true

Quellen