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.

La méthode valueOf() renvoie la valeur primitive d'un objet Date.

Exemple interactif

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

Syntaxe

js
date.valueOf();

Valeur de retour

Le nombre de millisecondes écoulées entre le premier janvier 1970, minuit UTC et la date indiquée.

Description

La méthode valueOf() renvoie la valeur primitive d'un objet Date sous forme d'un nombre. Ce nombre correspond au nombre de millisecondes écoulées depuis le 1 janvier 1970 00h00 GMT.

D'un point de vue fonctionnel, cette méthode est équivalente à Date.prototype.getTime().

Cette méthode est souvent appelée en interne par le moteur JavaScript et n'est pas utilisée de façon explicite dans des scripts.

Exemples

Utiliser valueOf()

js
var x = new Date(56, 6, 17);
var maVar = x.valueOf(); // maVar vaut -424713600000

Spécifications

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

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi