Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Datas e horas

Um objeto Date representa um instante como milissegundos desde o início de 1970 em UTC. Distinga um instante, uma representação de calendário local e uma duração para evitar erros relacionados com fusos horários.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new Date(milliseconds)
new Date("YYYY-MM-DDTHH:mm:ss.sssZ")
date.getTime()
date.toISOString()

Date armazena um instante como um número inteiro de milissegundos desde 1970-01-01T00:00:00.000Z; valores negativos representam instantes anteriores. Não armazena um fuso horário. getTime() devolve esse número, enquanto toISOString() representa o instante em UTC com um Z no final.

Um instante, uma data e hora locais e uma duração são conceitos diferentes. Os métodos locais interpretam um instante no fuso horário do ambiente, enquanto os métodos UTC utilizam UTC. As mudanças da hora podem fazer com que um dia local não tenha 24 horas. Assim, adicionar 86400000 milissegundos significa 24 horas, não necessariamente a mesma hora local no dia seguinte.

Ao analisar texto, utilize o formato padrão com um Z ou um desvio explícito. Sem desvio, YYYY-MM-DD é interpretado como UTC, mas uma data e hora é interpretada como hora local. Outros formatos podem depender da implementação. Um Date inválido tem um valor de tempo NaN; verifique-o com Number.isNaN(date.getTime()). Chamar toISOString() nesse objeto lança um RangeError.

O exemplo adiciona 90 minutos a um instante fixo e calcula a diferença em segundos. As operações apresentadas pertencem ao ECMAScript, não às Web APIs dos browsers.

Exemplos

const start = new Date("2024-01-01T00:00:00.000Z");
const end = new Date(start.getTime() + 90 * 60 * 1000);
console.log(end.toISOString());
console.log((end.getTime() - start.getTime()) / 1000);

Resultado

2024-01-01T01:30:00.000Z
5400

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes