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