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
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 especificarminutesValue
esecondsValue
.
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 Language Specification # sec-date.prototype.setutchours |
Compatibilidade com navegadores
BCD tables only load in the browser