Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Date.prototype.getUTCHours: hora em UTC

getUTCHours devolve a hora entre 0 e 23 obtida em UTC do valor temporal de um objeto Date.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

date.getUTCHours()

date.getUTCHours() devolve a hora UTC como Number entre 0 e 23. Ao contrário de getHours(), não depende do fuso local nem de regras de horário de verão. getUTCMinutes() e getUTCSeconds() leem os campos menores correspondentes.

O método não recebe argumentos, não altera a data e ignora argumentos adicionais. Devolve NaN para um Date inválido. Um receiver sem estado interno Date, como Date.prototype.getUTCHours.call({}), lança TypeError.

Usa-o para protocolos e cálculos em UTC; para apresentação ao utilizador costuma ser melhor Intl.DateTimeFormat com o fuso pretendido. O método existe desde ECMAScript 1.

Exemplos

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()));

Resultado

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

Fontes