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® 2025 Language Specification
# sec-date.utc

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
UTC
monthIndex defaults to 0

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Veja Também