Date.prototype.valueOf()

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 valueOf() 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 date1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5));

console.log(date1.valueOf());
// Expected output: 823230245000

const date2 = new Date("02 Feb 1996 03:04:05 GMT");

console.log(date2.valueOf());
// Expected output: 823230245000

Syntax

js
valueOf()

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

Die valueOf()-Methode ist Teil des Typumwandlungsprotokolls. Da Date eine [Symbol.toPrimitive]()-Methode hat, hat diese Methode immer Vorrang vor valueOf(), wenn ein Date-Objekt implizit in eine Zahl umgewandelt wird. Dennoch ruft Date.prototype[Symbol.toPrimitive]() intern this.valueOf() auf.

Das Date-Objekt überschreibt die valueOf()-Methode von Object. Date.prototype.valueOf() gibt den Zeitstempel des Datums zurück, was funktional der Date.prototype.getTime()-Methode entspricht.

Beispiele

Verwendung von valueOf()

js
const d = new Date(0); // 1970-01-01T00:00:00.000Z
console.log(d.valueOf()); // 0

Spezifikationen

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

Browser-Kompatibilität

Siehe auch