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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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 !
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
Spécification | État | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.0 |
ECMAScript 5.1 (ECMA-262) La définition de 'Date.prototype.setHours' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Date.prototype.setHours' dans cette spécification. |
Standard | |
ECMAScript (ECMA-262) La définition de 'Date.prototype.setHours' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
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.