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 Epoche zurück, die 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 äquivalent zur valueOf()-Methode.

Beispiele

Verwendung von getTime() zum Kopieren von Daten

Erstellen 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

Das Subtrahieren von zwei aufeinanderfolgenden getTime()-Aufrufen an neu generierten Date-Objekten ergibt den Zeitraum zwischen diesen beiden Aufrufen. Dies kann verwendet werden, um die Ausführungszeit einiger Operationen zu berechnen. Siehe auch Date.now(), um das Erstellen 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 das Hochauflösungszeit-Feature der Performance API unterstützen, kann Performance.now() zuverlässigere und präzisere Messungen der verstrichenen Zeit bereitstellen als Date.now().

Spezifikationen

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

Browser-Kompatibilität

Siehe auch