Date : méthode setUTCHours()

Exemple interactif

const event = new Date("August 19, 1975 23:15:30 GMT-3:00");

console.log(event.toUTCString());
// Résultat attendu : "Wed, 20 Aug 1975 02:15:30 GMT"

console.log(event.getUTCHours());
// Résultat attendu : 2

event.setUTCHours(23);

console.log(event.toUTCString());
// Résultat attendu : "Wed, 20 Aug 1975 23:15:30 GMT"

Syntaxe

setUTCHours(hoursValue)
setUTCHours(hoursValue, minutesValue)
setUTCHours(hoursValue, minutesValue, secondsValue)
setUTCHours(hoursValue, minutesValue, secondsValue, msValue)

Paramètres

hoursValue

Un entier compris entre 0 et 23 représentant les heures.

minutesValue Facultatif

Un entier compris entre 0 et 59 représentant les minutes.

secondsValue Facultatif

Un entier compris entre 0 et 59 représentant les secondes. Si vous définissez secondsValue, vous devez aussi définir minutesValue.

msValue Facultatif

Un entier compris entre 0 et 999 représentant les millisecondes. Si vous définissez msValue, vous devez aussi définir minutesValue et secondsValue.

Valeur de retour

Modifie l'objet Date en place et retourne son nouveau timestamp. Si un paramètre vaut NaN (ou d'autres valeurs qui sont contraintes en NaN, comme undefined), la date est définie sur Date invalide et NaN est retourné.

Description

Si vous ne définissez pas les paramètres minutesValue, secondsValue et msValue, les valeurs retournées par les méthodes getUTCMinutes(), getUTCSeconds() et getUTCMilliseconds() sont utilisées.

Si un paramètre que vous définissez est en dehors de la plage attendue, setUTCHours() tente de mettre à jour les informations de date dans l'objet Date en conséquence. Par exemple, si vous utilisez 100 pour secondsValue, les minutes seront incrémentées de 1 (minutesValue + 1), et 40 sera utilisé pour les secondes.

Exemples

Utiliser la méthode setUTCHours()

const leGrandJour = new Date();
leGrandJour.setUTCHours(8);

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthode Date.prototype.getUTCHours()
• La méthode Date.prototype.setHours()