Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Date.prototype.getTime: milisekundy od epochy

getTime vrací časovou hodnotu objektu Date jako milisekundy od unixové epochy nezávislé na časovém pásmu.

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

Syntaxe

date.getTime()

date.getTime() vrací interní časovou hodnotu jako Number: milisekundy od 1970-01-01T00:00:00Z. Hodnoty před epochou jsou záporné. Výsledek nezávisí na místním pásmu a odpovídá date.valueOf(), takže se hodí k porovnání, řazení a klonování přes new Date(date.getTime()).

Pro neplatný Date metoda vrací NaN. Platné hodnoty Date jsou celé milisekundy omezené TimeClip na ±8.64e15. Metoda nemá argumenty, objekt nemění a další argumenty ignoruje.

Receiver musí mít interní stav Date; Date.prototype.getTime.call({}) vyvolá TypeError. Metoda existuje od ECMAScript 1.

Příklady

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

Výsledek

1704067200123
true false
-1
true

Zdroje