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 Methode getTime() für Date-Instanzen gibt die Anzahl der Millisekunden seit der Mitternacht des 1. Januar 1970, UTC, zurück. Diese wird auch als Epoche definiert.

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 für dieses Datum 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, diesen Zeitstempel abzurufen. Sie können diese Methode verwenden, um einem anderen Date-Objekt ein Datum und eine Uhrzeit zuzuweisen. Diese Methode ist funktional identisch mit der Methode valueOf().

Beispiele

Verwendung von getTime() zum Kopieren von Daten

Erstellen eines Datumsobjekts 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

Die Subtraktion zweier aufeinanderfolgender getTime()-Aufrufe auf neu erstellten Date-Objekten ergibt die Zeitspanne zwischen diesen beiden Aufrufen. Dies kann verwendet werden, um die Ausführungszeit bestimmter 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() zuverlässigere und genauere Messungen der verstrichenen Zeit liefern als Date.now().

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch