Date : méthode setTime()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode setTime() des instances de Date modifie le timestamp pour cette date, c'est-à-dire le nombre de millisecondes écoulées depuis l'epoch, définie comme minuit au début du 1er janvier 1970, UTC.
Exemple interactif
const launchDate = new Date("July 1, 1999, 12:00:00");
const futureDate = new Date();
futureDate.setTime(launchDate.getTime());
console.log(futureDate);
// Résultat attendu : "Thu Jul 01 1999 12:00:00 GMT+0200 (CEST)"
const fiveMinutesInMillis = 5 * 60 * 1000;
futureDate.setTime(futureDate.getTime() + fiveMinutesInMillis);
console.log(futureDate);
// Résultat attendu : "Thu Jul 01 1999 12:05:00 GMT+0200 (CEST)"
// Remarque : votre fuseau horaire peut varier
Syntaxe
setTime(timeValue)
Paramètres
timeValue-
Un entier représentant le nouveau timestamp — le nombre de millisecondes écoulées depuis minuit au début du 1er janvier 1970, UTC.
Valeur de retour
Modifie l'objet Date en place et retourne son nouveau timestamp. Si timeValue vaut NaN (ou d'autres valeurs qui sont contraintes en NaN, comme undefined), la date est définie sur Date invalide et NaN est retourné.
Description
La méthode setTime() est utilisée afin d'assigner une date à un autre objet Date.
Exemples
Utiliser la méthode setTime()
const leGrandJour = new Date("1999-07-01");
const pareilQueGrandJour = new Date();
pareilQueGrandJour.setTime(leGrandJour.getTime());
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.settime |
Compatibilité des navigateurs
Voir aussi
- La méthode
Date.prototype.getTime() - La méthode
Date.prototype.setUTCHours()