База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Date.prototype.getTime: милисекунди от епохата

getTime връща времевата стойност на обект Date като милисекунди от Unix епохата, независимо от часовата зона.

Версия: ECMAScript 1 onward; example target: Node.js 24.22.2

Синтаксис

date.getTime()

date.getTime() връща вътрешната времева стойност като Number: милисекунди от 1970-01-01T00:00:00Z. Стойностите преди епохата са отрицателни. Резултатът не зависи от местната зона и е равен на date.valueOf(), затова служи за сравняване, сортиране и клониране с new Date(date.getTime()).

За невалиден Date методът връща NaN. Валидните стойности Date са цели милисекунди, ограничени от TimeClip до ±8.64e15. Методът няма аргументи, не променя обекта и игнорира допълнителните аргументи.

Receiver трябва да има вътрешно състояние Date; Date.prototype.getTime.call({}) хвърля TypeError. Методът съществува от ECMAScript 1.

Примери

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

Резултат

1704067200123
true false
-1
true

Източници