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