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 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

Compatibilidade de navegador

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.

Veja também

• Date.prototype.getUTCHours()
• Date.prototype.setHours()