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 Epoch zurück, das 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 von diesem Datum darstellt. Gibt NaN zurück, wenn das Datum ungültig ist.

Beschreibung

Die valueOf() Methode ist Teil des Typumwandlungs-Protokolls. Da Date eine [Symbol.toPrimitive]() Methode hat, hat diese Methode immer Vorrang gegenüber valueOf(), wenn ein Date Objekt implizit zu einer Zahl umgewandelt wird. Jedoch ruft Date.prototype[Symbol.toPrimitive]() intern trotzdem this.valueOf() auf.

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

Beispiele

Nutzung 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