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 seit dem Epoch-Zeitpunkt für dieses Datum zurück, wobei der Epoch-Zeitpunkt als Mitternacht 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 dieses Datums in Millisekunden 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. Allerdings ruft Date.prototype[Symbol.toPrimitive]() intern immer noch 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 Date.prototype.getTime() Methode ist.

Beispiele

Verwendung von valueOf()

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch