CKTIS / JavaScript
Date — времеви отметки и годината в UTC
Date съхранява времева отметка. Научете как да прочитате и промените годината в UTC, как се променя обектът и как се нормализират датите, включително преместването на 29 февруари в невисокосна година.
Версия: 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(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])Date е вграден обект на ECMAScript, който съхранява милисекундите от 1970-01-01T00:00:00.000Z или NaN при невалидна дата. Той не съхранява часова зона. Локалните методи интерпретират същата времева отметка според часовата зона на средата; методите UTC използват UTC.
Date.prototype.getUTCFullYear() връща пълната година в UTC или NaN при невалидна дата. Date.prototype.setUTCFullYear(year[, month[, day]]) променя обекта и връща получената времева отметка, а не обект Date. Месеците използват индексите 0–11, а дните от месеца започват от 1. Ако първоначалната дата е валидна, за всеки пропуснат аргумент за месец или ден методът използва съответната първоначална стойност в UTC като входна стойност. Нормализацията може да промени месеца и деня в резултата. Ако резултатът е валиден, часът в UTC остава непроменен.
Setter нормализира стойностите: промяната на годината на 29 февруари към невисокосна година води до 1 март. Година в диапазона 0–99 се тълкува буквално, за разлика от конструктора Date с няколко аргумента. При невалидна дата setter използва времевата отметка 0 като начална стойност; невалидни числови аргументи все пак могат да доведат до NaN.
Примерът използва изрично Z и методи UTC, така че резултатът да не зависи от местната часова зона. Той проверява и дали върнатата времева отметка съвпада с променения обект.
Примери
const date = new Date("2024-02-29T12:00:00.000Z");
console.log(date.getUTCFullYear());
const timestamp = date.setUTCFullYear(2025);
console.log(date.toISOString());
console.log(timestamp === date.getTime());Резултат
2024 2025-03-01T12:00:00.000Z true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.