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.

O método setUTCHours() atribui a hora para a data especificada de acordo com o horário universal, e retorna o número de milissegundos desde 1 de Janeiro de 1970 00:00:00 UTC até o horário representado pela instância Date atualizada.

Experimente

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"

Sintaxe

dateObj.setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])

Parâmetros

hoursValue: Um inteiro entre 0 e 23, representando a hora.
minutesValue: Opcional. Um inteiro entre 0 e 59, representando os minutos.
secondsValue: Opcional. Um inteiro entre 0 e 59, representando os segundos. Se você especificar o parâmetro secondsValue, você também deve especificar minutesValue.
msValue: Opcional. Um número entre 0 e 999, representando os milissegundos. Se você especificar o parâmetro msValue, você também deve especificar minutesValue e secondsValue.

Valor de retorno

O número de milissegundos entre 1 de Janeiro de 1970 00:00:00 UTC e a data atualizada.

Descrição

Se você não especificar os parâmetros minutesValue, secondsValue, e msValue, os valores retornados dos métodos getUTCMinutes(), getUTCSeconds(), e getUTCMilliseconds() serão utilizados.

Se o parâmetro que você especificou estiver fora do alcance esperado, setUTCHours() tentará atualizar a informação da data no objeto Date. Por exemplo, se você usa 100 para secondsValue, os minutos serão incrementados em 1 (minutesValue + 1), e 40 será usado para os segundos.

Exemplos

Usando `setUTCHours()`

var theBigDay = new Date();
theBigDay.setUTCHours(8);

Especificações

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