La méthode setUTCHours()
définit les heures pour la date, selon UTC, et renvoie le nombre de millièmes de secondes écoulées entre le 1er janvier 1970 00:00:00 UTC et cette nouvelle date.
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.setUTCHours(valeurHeures[, valeurMinutes[, valeurSecondes[, valeurMs]]])
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 le paramètre
valeurSecondes
est utilisé, le paramètrevaleurMinutes
devra également être renseigné. valeurMs
- Paramètre optionnel, un entier entre 0 et 999, représentant les millièmes de secondes. Si le paramètre
valeurMs
est utilisé, les paramètresvaleurMinutes
etvaleurSecondes
devront également être renseignés.
Valeur de retour
Le nombre de millisecondes écoulées entre le premier janvier 1970 minuit, UTC et la date mise à jour.
Description
Si les paramètres valeurMinutes
, valeurSecondes
et valeurMs
ne sont pas renseignés, les valeurs renvoyées par les méthodes getUTCMinutes()
, getUTCSeconds()
, et getUTCMilliseconds()
seront utilisées.
Si un des paramètres renseignés est en dehors des limites attendues, setUTCHours()
tentera de mettre à jour la date en conséquence. Par exemple, si on utilise la valeur 100 pour valeurSecondes
, les minutes seront incrémentées de 1 (min + 1), et 40 sera utilisé pour les secondes.
Exemples
Utiliser setUTCHours()
var leGrandJour = new Date();
leGrandJour.setUTCHours(8);
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.3. |
ECMAScript 5.1 (ECMA-262) La définition de 'Date.prototype.setUTCHours' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Date.prototype.setUTCHours' dans cette spécification. |
Standard | |
ECMAScript (ECMA-262) La définition de 'Date.prototype.setUTCHours' 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.