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

CKTIS / JavaScript

Date.prototype.getTime: milissegundos desde a época

getTime devolve o valor temporal de um objeto Date como milissegundos desde a época Unix, independente do fuso horário.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

date.getTime()

date.getTime() devolve o valor temporal interno como Number: milissegundos desde 1970-01-01T00:00:00Z. Valores anteriores à época são negativos. O resultado não depende do fuso local e equivale a date.valueOf(), sendo útil para comparar, ordenar e clonar com new Date(date.getTime()).

Para um Date inválido devolve NaN. Valores Date válidos são milissegundos inteiros limitados por TimeClip a ±8.64e15. O método não recebe argumentos, não altera o objeto e ignora argumentos adicionais.

O receiver tem de possuir estado interno Date; Date.prototype.getTime.call({}) lança TypeError. O método existe desde ECMAScript 1.

Exemplos

const original = new Date("2024-01-01T00:00:00.123Z");
const timestamp = original.getTime();
const clone = new Date(timestamp);

console.log(timestamp);
console.log(clone.getTime() === original.getTime(), clone === original);
console.log(new Date(-1).getTime());
console.log(Number.isNaN(new Date(NaN).getTime()));

Resultado

1704067200123
true false
-1
true

Fontes