We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

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

Especificação Status Comentário
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.UTC' in that specification.
Padrão  
ECMAScript 5.1 (ECMA-262)
The definition of 'Date.UTC' in that specification.
Padrão  
ECMAScript 1st Edition (ECMA-262) Padrão Definição inicial. Implementado no JavaScript 1.0.

Compatibilidade entre navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte Básico ? ? ? ? ? ?

Veja Também

Etiquetas do documento e colaboradores

Etiquetas: 
Colaboradores desta página: LeonardoBos
Última atualização por: LeonardoBos,