Date.UTC()

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 Date.UTC() aceita os mesmos parâmetros que o construtor mais longo de Date e retorna o total de milisegundos desde 1º de Janeiro de 1970 às 00:00:00 (horário universal). O valor retornado por Date.UTC() pode ser usado como parâmetro para criar uma instância de Date.

Sintaxe

Date.UTC(ano, mês[, dia[, hora[, minuto[, segundo[, milisegundo]]]]])

Parâmetros

ano

Um valor inteiro representando o ano, após 1970.

mês

Um valor inteiro que representa o mês, começando com 0 para Janeiro até 11 para Dezembro.

dia

Opcional. Um valor inteiro entre 1 e 31 representando o dia do mês.

hora

Opcional. Um valor inteiro entre 0 e 23 representando a hora do dia.

minuto

Opcional. Um valor entre 0 e 59 representando os minutos.

segundo

Opcional. Um valor entre 0 e 59 representando os segundos.

milisegundo

Opcional. Um valor entre 0 e 999 representando os milisegundos.

Descrição

UTC() recebe argumentos de uma data separados por vírgula e retorna um número representando o total de milisegundos entre o dia 1º de Janeiro de 1970 às 00:00:00 (horário universal) e a data e hora que você especificou.

Você deve especificar o ano completo para o argumento ano. Por exemplo, 1998. Se o ano fornecido for um valor entre 0 e 99 o método irá converter este valor para o século 20 (1900 + ano); Por exemplo, se você utilizar 95, então o ano 1995 será utilizado.

O método UTC() se diferencia do construtor de Date de duas maneiras:

  • Date.UTC() utiliza o horário universal em vez do horário local.
  • Date.UTC() retorna um valor inteiro em vez de uma instância de Date.

Se você fornecer um argumento fora do intervalo esperado, o método UTC() atualiza os demais argumentos para permitir este valor. Por exemplo, se você utilizar 15 para mês, será adicionado 1 ao argumento ano (ano + 1) e será utilizado 3 para o argumento mês.

UTC() é um método estático, por conta disto você sempre irá chamar Date.UTC() em vez de chamar um método de um objeto Date que você tenha criado.

Exemplos

Utilizando Date.UTC()

A seguinte expressão cria uma instância de Date utilizando UTC em vez do horário local:

var dataUniversal = new Date(Date.UTC(96, 11, 1, 0, 0, 0));

Especificações

Specification
ECMAScript Language Specification
# sec-date.utc

Compatibilidade com navegadores

BCD tables only load in the browser

Veja Também