Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Date.prototype.getTime : millisecondes depuis l’époque

getTime renvoie la valeur temporelle d’un objet Date en millisecondes depuis l’époque Unix, indépendamment du fuseau.

Version : ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

date.getTime()

date.getTime() renvoie la valeur temporelle interne comme Number : millisecondes depuis 1970-01-01T00:00:00Z. Les valeurs antérieures sont négatives. Le résultat ne dépend pas du fuseau local et équivaut à date.valueOf(), ce qui sert à comparer, trier et cloner avec new Date(date.getTime()).

Pour un Date invalide, la méthode renvoie NaN. Les valeurs Date valides sont des millisecondes entières limitées par TimeClip à ±8.64e15. La méthode ne prend aucun argument, ne modifie pas l’objet et ignore les arguments supplémentaires.

Le receiver doit avoir l’état interne Date ; Date.prototype.getTime.call({}) lève TypeError. La méthode existe depuis ECMAScript 1.

Exemples

const original = new Date("2024-01-01T00:00:00.123Z");
const timestamp = original.getTime();
const clone = new Date(timestamp);

console.log(timestamp);
console.log(clone.getTime() === original.getTime(), clone === original);
console.log(new Date(-1).getTime());
console.log(Number.isNaN(new Date(NaN).getTime()));

Résultat

1704067200123
true false
-1
true

Sources