Date.prototype.setSeconds()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode setSeconds() définit les secondes pour la date, selon l'heure locale.

Exemple interactif

const event = new Date("August 19, 1975 23:15:30");

event.setSeconds(42);

console.log(event.getSeconds());
// Expected output: 42

console.log(event);
// Expected output: "Sat Apr 19 1975 23:15:42 GMT+0100 (CET)"
// Note: your timezone may vary

Syntaxe

dateObj.setSeconds(valeurSecondes[, valeurMs])

Versions antérieures à JavaScript 1.3

dateObj.setSeconds(valeurSecondes);

Paramètres

valeurSecondes: Un entier entre 0 et 59.
valeurMs: Paramètre optionnel, un nombre entre 0 et 999, représentant les millièmes de secondes.

Valeur de retour

Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.

Description

Si le paramètre valeurMs n'est pas utilisé, la valeur renvoyée par la méthode getMilliseconds() sera utilisée.

Si un paramètre utilisé est en dehors des limites attendues, setSeconds() tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 100 pour valeurSecondes, les minutes de la date seront incrémentées de 1, et 40 sera utilisé pour les secondes.

Exemples

Utiliser `setSeconds()`

var leGrandJour = new Date();
leGrandJour.setSeconds(30);

Spécifications

Specification
ECMAScript® 2026 Language Specification # sec-date.prototype.setseconds