Date.prototype.setUTCHours()

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 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.

Exemple interactif

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

console.log(event.toUTCString());
// Expected output: "Wed, 20 Aug 1975 02:15:30 GMT"

console.log(event.getUTCHours());
// Expected output: 2

event.setUTCHours(23);

console.log(event.toUTCString());
// Expected output: "Wed, 20 Aug 1975 23:15:30 GMT"

Syntaxe

js
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ètre valeurMinutes 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ètres valeurMinutes et valeurSecondes 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()

js
var leGrandJour = new Date();
leGrandJour.setUTCHours(8);

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-date.prototype.setutchours

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setUTCHours

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi