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 julho de 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 especificarminutesValue. msValue-
Opcional. Um número entre 0 e 999, representando os milissegundos. Se você especificar o parâmetro
msValue, você também deve especificarminutesValueesecondsValue.
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> |
Compatibilidade com navegadores
Loading…