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 für dieses Datum seit dem Epochenbeginn zurück, der 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 in Millisekunden dieses Datums darstellt. Gibt NaN zurück, wenn das Datum ungültig ist.

Beschreibung

Date-Objekte werden grundsätzlich 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 gleichwertig mit der valueOf()-Methode.

Beispiele

Verwendung von getTime() zum Kopieren von Datumsangaben

Erstellung 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());

Messung der Ausführungszeit

Durch das Subtrahieren von zwei aufeinanderfolgenden getTime()-Aufrufen auf neu erzeugten Date-Objekten erhält man die Zeitspanne zwischen diesen beiden Aufrufen. Dies kann verwendet werden, um die Ausführungszeit einiger Operationen 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 hochauflösende Zeitfunktion der Performance API unterstützen, kann Performance.now() verlässlichere und präzisere Messungen der vergangenen Zeit als Date.now() bieten.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch