CKTIS / JavaScript
Дати и час
Обектът Date представя момент като милисекунди от началото на 1970 г. в UTC. Разграничавайте момент, местно календарно представяне и продължителност, за да избегнете грешки, свързани с часовите зони.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new Date(milliseconds)
new Date("YYYY-MM-DDTHH:mm:ss.sssZ")
date.getTime()
date.toISOString()Date съхранява момент като цяло число милисекунди от 1970-01-01T00:00:00.000Z; отрицателните стойности представят по-ранни моменти. Той не съхранява часова зона. getTime() връща това число, а toISOString() представя момента в UTC с крайно Z.
Моментът, местните дата и час и продължителността са различни понятия. Местните методи интерпретират момента в часовата зона на средата, докато методите UTC използват UTC. Промените на часовника могат да направят местния ден различен от 24 часа. Следователно добавянето на 86400000 милисекунди означава 24 часа, но не непременно същия местен час на следващия ден.
При обработка на текст използвайте стандартния формат с изрично Z или отместване. Без отместване YYYY-MM-DD се интерпретира като UTC, а дата с час — като местно време. Други формати може да зависят от реализацията. Невалиден Date има времева стойност NaN; проверете я с Number.isNaN(date.getTime()). Извикването на toISOString() за такъв обект поражда RangeError.
Примерът добавя 90 минути към фиксиран момент и изчислява разликата в секунди. Показаните операции са част от ECMAScript, а не от уеб API-тата на браузъра.
Примери
const start = new Date("2024-01-01T00:00:00.000Z");
const end = new Date(start.getTime() + 90 * 60 * 1000);
console.log(end.toISOString());
console.log((end.getTime() - start.getTime()) / 1000);Резултат
2024-01-01T01:30:00.000Z 5400
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.