Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Date.prototype.getTime: milisekundy od epoki

getTime zwraca wartość czasu obiektu Date jako liczbę milisekund od epoki Unix, niezależną od strefy czasowej.

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

Składnia

date.getTime()

date.getTime() zwraca jako Number wewnętrzną wartość czasu: milisekundy od 1970-01-01T00:00:00Z. Wartości przed epoką są ujemne. Wynik jest niezależny od lokalnej strefy i odpowiada date.valueOf(), dlatego nadaje się do porównywania, sortowania i klonowania przez new Date(date.getTime()).

Dla niepoprawnego Date metoda zwraca NaN. Poprawne wartości Date są całkowitymi milisekundami ograniczonymi przez TimeClip do ±8.64e15. Metoda nie przyjmuje argumentów, nie zmienia obiektu i ignoruje dodatkowe argumenty.

Receiver musi mieć wewnętrzny stan Date; Date.prototype.getTime.call({}) powoduje TypeError. Metoda istnieje od ECMAScript 1.

Przykłady

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

Wynik

1704067200123
true false
-1
true

Źródła