CKTIS / JavaScript
Daty i czas
Obiekt Date reprezentuje chwilę jako liczbę milisekund od początku 1970 roku w UTC. Odróżniaj chwilę, lokalny zapis kalendarzowy i czas trwania, aby unikać błędów związanych ze strefami czasowymi.
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("YYYY-MM-DDTHH:mm:ss.sssZ")
date.getTime()
date.toISOString()Date przechowuje chwilę jako całkowitą liczbę milisekund od 1970-01-01T00:00:00.000Z; wartości ujemne oznaczają wcześniejsze chwile. Nie przechowuje strefy czasowej. getTime() zwraca tę liczbę, a toISOString() zapisuje chwilę w UTC z końcówką Z.
Chwila, lokalna data z godziną i czas trwania to różne pojęcia. Metody lokalne interpretują chwilę w strefie środowiska, a metody UTC używają UTC. Zmiany czasu mogą sprawić, że lokalna doba nie trwa 24 godzin. Dodanie 86400000 milisekund oznacza więc 24 godziny, niekoniecznie tę samą godzinę następnego dnia lokalnego.
Przy odczytywaniu tekstu używaj standardowego formatu z jawnym Z lub przesunięciem. Bez przesunięcia zapis YYYY-MM-DD jest interpretowany jako UTC, ale zapis daty z godziną jako czas lokalny. Inne formaty mogą zależeć od implementacji. Niepoprawny Date ma wartość czasu NaN; sprawdzisz ją przez Number.isNaN(date.getTime()). Wywołanie toISOString() dla takiego obiektu zgłasza RangeError.
Przykład dodaje 90 minut do ustalonej chwili i oblicza różnicę w sekundach. Pokazane operacje należą do ECMAScript, nie do przeglądarkowych Web APIs.
Przykłady
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);Wynik
2024-01-01T01:30:00.000Z 5400
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.