Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła