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

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

Sources