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