CKTIS / JavaScript
Date — znaczniki czasu i rok w UTC
Date przechowuje znacznik czasu. Poznaj odczyt i zmianę roku w UTC, mutowanie obiektu oraz normalizację dat, w tym zmianę 29 lutego na rok nieprzestępny.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])Date to wbudowany obiekt ECMAScript przechowujący liczbę milisekund od 1970-01-01T00:00:00.000Z albo NaN dla nieprawidłowej daty. Nie przechowuje strefy czasowej. Metody lokalne interpretują ten sam znacznik według strefy środowiska; metody UTC używają UTC.
Date.prototype.getUTCFullYear() zwraca pełny rok w UTC, a dla nieprawidłowej daty — NaN. Date.prototype.setUTCFullYear(year[, month[, day]]) zmienia obiekt i zwraca wynikowy znacznik czasu, nie obiekt Date. Miesiące mają indeksy 0–11, a dni miesiąca zaczynają się od 1. Jeśli data wejściowa jest prawidłowa, dla każdego pominiętego argumentu miesiąca lub dnia metoda używa dotychczasowej wartości w UTC jako danych wejściowych do normalizacji. W wyniku normalizacji miesiąc i dzień mogą się zmienić. Jeśli wynik jest prawidłowy, pora dnia w UTC pozostaje bez zmian.
Setter normalizuje wartości: zmiana roku daty 29 lutego na nieprzestępny daje 1 marca. Rok 0–99 jest traktowany dosłownie, inaczej niż w wieloargumentowym konstruktorze Date. Dla nieprawidłowej daty setter używa znacznika 0 jako podstawy; nieprawidłowe argumenty liczbowe mogą jednak dać NaN.
Przykład używa jawnego Z i metod UTC, aby wynik nie zależał od lokalnej strefy. Sprawdza również, że zwrócony znacznik odpowiada zmienionemu obiektowi.
Przykłady
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());Wynik
2024 2025-03-01T12:00:00.000Z true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.