Date.prototype.setHours()
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 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.
Exemple interactif
Syntaxe
dateObj.setHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]])
Versions antérieures à JavaScript 1.3
dateObj.setHours(valeurHeures);
Paramètres
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 renseignervaleurMinutes
. 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 renseignervaleurMinutes
etvaleurSecondes
. Si la valeur fournie est supérieure à 999, l'heure sera incrémentée d'autant de millisecondes supplémentaires.
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
Specification |
---|
ECMAScript Language Specification # sec-date.prototype.sethours |
Compatibilité des navigateurs
BCD tables only load in the browser