Date.prototype.getTime()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die getTime() Methode von Date Instanzen gibt die Anzahl der Millisekunden seit dem Epoche für dieses Datum zurück, das als Mitternacht zu Beginn des 1. Januar 1970, UTC, definiert ist.

Probieren Sie es aus

const moonLanding = new Date("July 20, 69 20:17:40 GMT+00:00");

// Milliseconds since Jan 1, 1970, 00:00:00.000 GMT
console.log(moonLanding.getTime());
// Expected output: -14182940000

Syntax

js
getTime()

Parameter

Keine.

Rückgabewert

Eine Zahl, die den Zeitstempel dieses Datums in Millisekunden darstellt. Gibt NaN zurück, wenn das Datum ungültig ist.

Beschreibung

Date Objekte werden grundlegend durch einen Zeitstempel dargestellt, und diese Methode ermöglicht es Ihnen, den Zeitstempel abzurufen. Sie können diese Methode verwenden, um einem anderen Date Objekt ein Datum und eine Uhrzeit zuzuweisen. Diese Methode ist funktional äquivalent zur valueOf() Methode.

Beispiele

Verwendung von getTime() zum Kopieren von Datumsangaben

Konstruktion eines Date-Objekts mit demselben Zeitwert.

js
// Since month is zero based, birthday will be January 10, 1995
const birthday = new Date(1994, 12, 10);
const copy = new Date();
copy.setTime(birthday.getTime());

Messen der Ausführungszeit

Das Subtrahieren von zwei aufeinanderfolgenden getTime() Aufrufen auf neu erstellten Date Objekten ergibt die Zeitspanne zwischen diesen beiden Aufrufen. Dies kann verwendet werden, um die Ausführungszeit einiger Vorgänge zu berechnen. Siehe auch Date.now(), um die Erstellung unnötiger Date Objekte zu vermeiden.

js
let end, start;

start = new Date();
for (let i = 0; i < 1000; i++) {
  Math.sqrt(i);
}
end = new Date();

console.log(`Operation took ${end.getTime() - start.getTime()} msec`);

Hinweis: In Browsern, die die High-Resolution Time-Funktion der Performance-API unterstützen, kann Performance.now() präzisere und zuverlässigere Messungen der verstrichenen Zeit liefern als Date.now().

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.gettime

Browser-Kompatibilität

Siehe auch