Date : méthode valueOf()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode valueOf() des instances de Date retourne le nombre de millisecondes pour cette date depuis l'époch, qui est définie comme le passage à minuit du 1er janvier 1970, UTC.
Exemple interactif
const date1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5));
console.log(date1.valueOf());
// Résultat attendu : 823230245000
const date2 = new Date("02 Feb 1996 03:04:05 GMT");
console.log(date2.valueOf());
// Résultat attendu : 823230245000
Syntaxe
valueOf()
Paramètres
Aucun.
Valeur de retour
Un nombre représentant le timestamp, en millisecondes, de cette date. Retourne NaN si la date est invalide.
Description
La méthode valueOf() fait partie du protocole de contrainte de type. Comme Date possède une méthode [Symbol.toPrimitive](), cette méthode a toujours la priorité sur valueOf() lorsqu'un objet Date est implicitement contraint en nombre. Cependant, Date.prototype[Symbol.toPrimitive]() appelle toujours this.valueOf() en interne.
L'objet Date surcharge la méthode valueOf() de Object. Date.prototype.valueOf() retourne le timestamp de la date, ce qui est fonctionnellement équivalent à la méthode Date.prototype.getTime().
Exemples
Utiliser la méthode valueOf()
const d = new Date(0); // 1970-01-01T00:00:00.000Z
console.log(d.valueOf()); // 0
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.valueof |
Compatibilité des navigateurs
Voir aussi
- La méthode
Object.prototype.valueOf() - La méthode
Date.prototype.getTime()