Date.prototype.valueOf()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
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
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()
const d = new Date(0); // 1970-01-01T00:00:00.000Z
console.log(d.valueOf()); // 0
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.valueof |