Date.prototype.getTime()

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 getTime() retorna o valor numérico correspondente ao horário da data especificada de acordo com o horário universal.

Você pode usar este método para atribuir uma data e horário a outro objeto Date. Este método é funcionalmente equivalente ao método valueOf().

Sintaxe

dateObj.getTime()

Retorna

Um número representando os milissegundos passados entre 1 de Janeiro de 1970 00:00:00 UTC e a data atual.

Exemplos

Usando getTime() para duplicar datas

Construindo um objeto de data com um horário idêntico.

js
// Sendo o mês iniciado em zero, birthday será 10 de Janeiro de 1995
var birthday = new Date(1994, 12, 10);
var copy = new Date();
copy.setTime(birthday.getTime());

Medindo tempo de execução

Subtrair duas chamadas subsequentes a getTime() em objetos Date recém criados resultará no intervalo de tempo entre essas duas chamadas. Isso pode ser usado para calcular o tempo de execução de algumas operações. Veja também Date.now() para evitar instanciar objetos Date desnecessariamente.

js
var end, start;

start = new Date();
for (var i = 0; i < 1000; i++) {
  Math.sqrt(i);
}
end = new Date();

console.log("Operation took " + (end.getTime() - start.getTime()) + " msec");

Especificações

Specification
ECMAScript® 2025 Language Specification
# sec-date.prototype.gettime

Compatibilidade com navegadores

BCD tables only load in the browser

See also