Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Date.prototype.getTime: milisegundos desde la época

getTime devuelve el valor temporal de un objeto Date como milisegundos desde la época Unix, sin depender de la zona horaria.

Versión: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxis

date.getTime()

date.getTime() devuelve el valor temporal interno como Number: milisegundos desde 1970-01-01T00:00:00Z. Los valores anteriores a la época son negativos. El resultado no depende de la zona local y equivale a date.valueOf(), útil para comparar, ordenar y clonar con new Date(date.getTime()).

Para un Date inválido devuelve NaN. Los valores Date válidos son milisegundos enteros limitados por TimeClip a ±8.64e15. El método no recibe argumentos, no modifica el objeto e ignora argumentos adicionales.

El receptor debe tener estado interno Date; Date.prototype.getTime.call({}) lanza TypeError. El método existe desde ECMAScript 1.

Ejemplos

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

Fuentes