Date : méthode setUTCSeconds()
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 setUTCSeconds() des instances de Date modifie les secondes et/ou les millièmes de secondes pour cette date selon le temps universel.
Exemple interactif
const date1 = new Date("December 31, 1975, 23:15:30 GMT+11:00");
console.log(date1.getUTCSeconds());
// Résultat attendu : 30
date1.setUTCSeconds(39);
console.log(date1.getUTCSeconds());
// Résultat attendu : 39
Syntaxe
setUTCSeconds(secondsValue)
setUTCSeconds(secondsValue, msValue)
Paramètres
secondsValue-
Un entier compris entre 0 et 59 représentant les secondes.
msValueFacultatif-
Un entier compris entre 0 et 999 représentant les millièmes de secondes.
Valeur de retour
Modifie l'objet Date en place et retourne son nouveau timestamp. Si un paramètre vaut NaN (ou d'autres valeurs qui sont contrainte en NaN, comme undefined), la date est définie sur Date invalide et NaN est retourné.
Description
Si vous ne définissez pas le paramètre msValue, la valeur retournée par la méthode getUTCMilliseconds() est utilisée.
Si un paramètre que vous définissez est en dehors de la plage attendue, setUTCSeconds() tente de mettre à jour les informations de date dans l'objet Date en conséquence. Par exemple, si vous utilisez 100 pour secondsValue, les minutes stockées dans l'objet Date seront incrémentées de 1, et 40 sera utilisé pour les secondes.
Exemples
Utiliser la méthode setUTCSeconds()
const leGrandJour = new Date();
leGrandJour.setUTCSeconds(20);
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setutcseconds |
Compatibilité des navigateurs
Voir aussi
- La méthode
Date.prototype.getUTCSeconds() - La méthode
Date.prototype.setSeconds()