Método setUTCHours() do JavaScript Date

Definição e uso

setUTCHours() O método ajusta a hora do objeto Date com base no tempo UTC.

Este método também pode ser usado para ajustar minutos, segundos e milissegundos.

Dica:O Tempo Universal Coordenado (UTC) é o tempo estabelecido pelo padrão de tempo mundial.

Observação:O tempo UTC é o mesmo que o GMT (Greenwich Mean Time).

Exemplo

Exemplo 1

Ajuste a hora para 15 conforme o tempo UTC:

var d = new Date();
d.setUTCHours(15);

Experimente você mesmo

Exemplo 2

Ajuste o tempo para 15:35:01 UTC:

var d = new Date();
d.setUTCHours(15, 35, 1);

Experimente você mesmo

Exemplo 3

Use o método UTC para ajustar o tempo para 48 horas antes:

var d = new Date();
d.setUTCHours(d.getUTCHours() - 48);

Experimente você mesmo

Sintaxe

Date.setUTCHours(hour, min, sec, millisec)

Valor do parâmetro

Parâmetro Descrição
hour

Obrigatório. Representa o inteiro das horas.

O valor esperado é de 0-23, mas outros valores são permitidos:

  • -1 causará a última hora do dia anterior
  • 24 causará a primeira hora do dia seguinte
min

Opcional. Representa o inteiro dos minutos.

O valor esperado é de 0-59, mas outros valores são permitidos:

  • -1 causará o último minuto do hora anterior
  • 60 causará o primeiro minuto do próximo hora
sec

Opcional. Representa o inteiro dos segundos.

O valor esperado é de 0-59, mas outros valores são permitidos:

  • -1 causará o último segundo do minuto anterior
  • 60 causará o primeiro segundo do próximo minuto
millisec

Opcional. Representa o inteiro dos milissegundos.

O valor esperado é de 0-999, mas outros valores são permitidos:

  • -1 causará o último milissegundo do segundo anterior
  • 1000 causará o primeiro milissegundo do próximo segundo

Detalhes técnicos

Retorno: Um número que representa os milissegundos entre o objeto Date e a meia-noite de 1 de janeiro de 1970.
Versão do JavaScript: ECMAScript 1

Suporte do navegador

Método Chrome IE Firefox Safari Opera
setUTCHours() Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

Tutorial:Data do JavaScript

Tutorial:Formato de data do JavaScript

Tutorial:Métodos de configuração de data do JavaScript