Date.prototype.setHours()

La méthode setHours() définit les heures pour une date donnée, selon l'heure locale, et renvoie le nombre de millièmes de secondes écoulées entre le 1er janvier 1970 00:00:00 UTC et la nouvelle date mise à jour.

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !

dateObj.setHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]])

dateObj.setHours(valeurHeures)

valeurHeures

Un entier normalement compris entre 0 et 23, représentant l'heure. Si la valeur est supérieure à 23, la valeur de l'heure sera incrémentée d'autant d'heures supplémentaires.

valeurMinutes

Paramètre optionnel, un entier normalement compris entre 0 et 59, représentant les minutes. Si la valeur est supérieure à 59, la valeur de l'heure sera incrémentée d'autant de minutes supplémentaires.

valeurSecondes

Paramètre optionnel, un entier normalement compris entre 0 et 59, représentant les secondes. Si vous indiquez le paramètre valeurSecondes, vous devez aussi renseigner valeurMinutes. Si la valeur est supérieure à 59, l'heure sera incrémentée d'autant de secondes supplémentaires.

valeurMs

Paramètre optionnel, un entier normalement compris entre 0 et 999, représentant les millièmes de secondes. Si vous indiquez valeurMs, vous devez aussi renseigner valeurMinutes et valeurSecondes. Si la valeur fournie est supérieure à 999, l'heure sera incrémentée d'autant de millisecondes supplémentaires.

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

Si vous ne renseignez pas valeurMinutes, valeurSecondes et valeurMs, les valeurs renvoyées par les méthodes getMinutes(), getSeconds(), et getMilliseconds() seront utilisées.

Si un des paramètres que vous renseignez est en dehors des limites attendues, setHours() tentera de mettre à jour la date en conséquence. Par exemple, si vous utilisez 100 pour valeurSecondes, les minutes seront incrémentées de 1 (min + 1), et 40 sera utilisé pour les secondes.

var leGrandJour = new Date();
leGrandJour.setHours(7);

Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.

• Date.prototype.getHours()
• Date.prototype.setUTCHours()