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.

Syntaxe

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

Versions antérieures à JavaScript 1.3

dateObj.setHours(valeurHeures)

Paramètres

valeurHeures

Un entier entre 0 et 23, représentant l'heure.

valeurMinutes

Paramètre optionnel, un entier entre 0 et 59, représentant les minutes.

valeurSecondes

Paramètre optionnel, un entier entre 0 et 59, représentant les secondes. Si vous indiquez le paramètre valeurSecondes, vous devez aussi renseigner valeurMinutes.

valeurMs

Paramètre optionnel, un entier entre 0 et 999, représentant les millièmes de secondes. Si vous indiquez valeurMs, vous devez aussi renseigner valeurMinutes et valeurSecondes.

Valeur de retour

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

Description

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.

Exemples

Utiliser setHours()

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

Spécifications

Compatibilité des navigateurs

Voir aussi

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