CKTIS / JavaScript
Date.prototype.setTime : remplacer la valeur temporelle
setTime remplace la valeur d’un Date par des millisecondes depuis l’époque, applique TimeClip et renvoie la nouvelle valeur.
Version : ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
date.setTime(timeValue)date.setTime(timeValue) convertit l’argument avec ToNumber, tronque une fraction vers zéro et stocke les millisecondes depuis 1970-01-01T00:00:00Z. L’opération ne dépend ni du fuseau local ni des anciens champs calendaires. Elle renvoie la valeur stockée, ensuite égale à getTime().
Une valeur non finie, NaN, un argument absent ou une valeur absolue supérieure à 8.64e15 invalide la date et renvoie NaN. Un appel valide ultérieur peut restaurer un Date invalide. BigInt et Symbol lèvent TypeError pendant ToNumber ; la coercition d’un objet peut aussi lever.
Un receiver sans état interne Date lève TypeError et les arguments supplémentaires sont ignorés. Utilisez setTime pour restaurer un horodatage ou décaler un instant en millisecondes. La méthode existe depuis ECMAScript 1.
Exemples
const date = new Date(0);
console.log(date.setTime(1704067200123.9));
console.log(date.toISOString());
console.log(date.setTime(8.64e15 + 1), Number.isNaN(date.getTime()));
console.log(date.setTime(0), date.toISOString());Résultat
1704067200123 2024-01-01T00:00:00.123Z NaN true 0 1970-01-01T00:00:00.000Z