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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
getTime

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch