Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Date.UTC: składniki UTC na znacznik czasu

Date.UTC interpretuje liczbowe składniki jako UTC, normalizuje je i zwraca milisekundy od epoki bez tworzenia obiektu Date.

Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2

Składnia

Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, milliseconds?)

Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, ms?) zwraca Number milisekund od epoki. monthIndex jest zerowy; domyślnie miesiąc to 0, dzień 1, a pola czasu 0. Lata 0–99 są specjalnie mapowane na 1900–1999. Funkcja zwraca liczbę, więc obiekt tworzysz przez new Date(Date.UTC(...)).

Wartości poza naturalnym zakresem są normalizowane, na przykład miesiąc 12 przechodzi do stycznia następnego roku, a dzień 0 do końca poprzedniego miesiąca. Po ToNumber i TimeClip wartość niekończona, brak wymaganego roku lub wynik poza ±8.64e15 daje NaN. BigInt i Symbol powodują TypeError.

Jako metoda statyczna Date.UTC nie używa lokalnej strefy. Dodatkowe argumenty są ignorowane i funkcja nie jest konstruktorem. Istnieje od ECMAScript 1.

Przykłady

const timestamp = Date.UTC(2024, 1, 29, 12, 30);
console.log(timestamp, new Date(timestamp).toISOString());
console.log(Date.UTC(2024, 12, 1) === Date.UTC(2025, 0, 1));
console.log(new Date(Date.UTC(99, 0, 1)).toISOString());
console.log(Number.isNaN(Date.UTC()));

Wynik

1709209800000 2024-02-29T12:30:00.000Z
true
1999-01-01T00:00:00.000Z
true

Źródła