Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Date.prototype.getUTCHours : heure en UTC

getUTCHours renvoie l’heure de 0 à 23 extraite en UTC de la valeur temporelle d’un objet Date.

Version : ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

date.getUTCHours()

date.getUTCHours() renvoie l’heure UTC comme Number de 0 à 23. Contrairement à getHours(), elle ne dépend ni du fuseau local ni des règles d’heure d’été. getUTCMinutes() et getUTCSeconds() lisent les champs plus petits correspondants.

La méthode ne prend aucun argument, ne modifie pas la date et ignore les arguments supplémentaires. Elle renvoie NaN pour un Date invalide. Un receiver sans état interne Date, tel que Date.prototype.getUTCHours.call({}), lève TypeError.

Utilisez-la pour les protocoles et calculs en UTC ; pour l’affichage, Intl.DateTimeFormat avec le fuseau voulu convient généralement mieux. La méthode existe depuis ECMAScript 1.

Exemples

const instant = new Date("2024-07-01T23:30:00-04:00");
console.log(instant.toISOString());
console.log(instant.getUTCHours(), instant.getUTCDate());
console.log(Number.isNaN(new Date(NaN).getUTCHours()));

Résultat

2024-07-02T03:30:00.000Z
3 2
true

Sources