Date.prototype.setUTCHours()
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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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
Especificação |
---|
ECMAScript (ECMA-262) The definition of 'Date.prototype.setUTCHours' in that specification. |
Compatibilidade de navegador
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.