Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Date.prototype.getTime: millisecondi dall’epoca

getTime restituisce il valore temporale di un oggetto Date come millisecondi dall’epoca Unix, indipendente dal fuso.

Versione: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintassi

date.getTime()

date.getTime() restituisce il valore temporale interno come Number: millisecondi da 1970-01-01T00:00:00Z. I valori prima dell’epoca sono negativi. Il risultato non dipende dal fuso locale ed equivale a date.valueOf(), utile per confrontare, ordinare e clonare con new Date(date.getTime()).

Per un Date non valido restituisce NaN. I valori Date validi sono millisecondi interi limitati da TimeClip a ±8.64e15. Il metodo non accetta argomenti, non modifica l’oggetto e ignora quelli aggiuntivi.

Il receiver deve avere lo stato interno Date; Date.prototype.getTime.call({}) genera TypeError. Il metodo esiste da ECMAScript 1.

Esempi

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()));

Risultato

1704067200123
true false
-1
true

Fonti