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-Zeitpunkt zurück, welcher 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 für dieses Datum darstellt. Gibt NaN zurück, wenn das Datum ungültig ist.

Beschreibung

Die valueOf()-Methode ist Teil des Typumwandlungsprotokolls. Da Date über eine [Symbol.toPrimitive]()-Methode verfügt, hat diese Methode immer Vorrang vor valueOf(), wenn ein Date-Objekt implizit in eine Zahl umgewandelt wird. Dennoch 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 Methode Date.prototype.getTime() 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

BCD tables only load in the browser

Siehe auch