Időpont-egyeztetés

A JavaScript rendelkezik egy beépített Date objektummal, amely dátumot és időt tárol, és metódusokat kínál a kezelésükhöz.

Létrehozás

A Date objektum a Date osztály egy példánya. Létrehozható úgy, hogy nem adunk át argumentumot a konstruktorfüggvénynek. Ekkor egy olyan Date objektumot kapunk, amely az aktuális dátumot és időt képviseli:

const now = new Date();
// => Thu Apr 14 2022 11:46:08 GMT+0530 (India Standard Time)
// Shows current day, date and time (in your time zone).

Unix timestamp (szám)

Ha egy számot adunk át, azt timestamp-ként értelmezi. A timestamp egy egész szám, amely az 1970. január 1. UTC+0 óta eltelt ezredmásodpercek számát jelöli.

const epoch = new Date(0);
// Thu Jan 01 1970 01:00:00 GMT+0100 (Central European Standard Time)

const another = new Date(1749508766627);
// Tue Jun 10 2025 00:39:26 GMT+0200 (Central European Summer Time)

Az ember azt várná, hogy a new Date(0) a „legkorábbi” dátumobjektumot hozza létre, de a JavaScript a helyi időzónádra konvertálja a dátumot, ami azt jelenti, hogy valójában csak azok kapják meg a Unix epoch értéket, akik GMT / UTC+0 időzónában vannak.

ISO 8601 timestamp (string)

Átadhatsz egy dátumot képviselő string értéket a Date konstruktornak. Az egyetlen olyan formátum, amely minden implementációban konzisztens, a nemzetközileg elismert és szabványosított, úgynevezett ISO 8601 timestamp stringek egyszerűsített változata.

Egy pillanat az időben UTC szerint így néz ki:

YYYY-MM-DDTHH:mm:ss.mssZ
YYYYMMDDTHHmmss.mssZ

Ahol a következő helyettesítések történnek:

A szó szerinti Z betű az UTC-t jelöli (nincs időzóna, nincs nyári időszámítás).

Mivel a legtöbb összetevőnek van alapértelmezett értéke, érvényes, ha a végét elhagyjuk:

YYYY-MM-DD

Alapértelmezésben 00:00:00.000 időre áll be.

Ha a timestamp nem Z-re végződik, és nem végződik +HH:mm-re vagy -HH:mm-re (ami időzóna-eltolást jelez), akkor történelmi okokból a következő érvényes:

Ha az időzóna-eltolás hiányzik, a csak dátumot tartalmazó formák UTC-időként, a dátumot és időt tartalmazó formák pedig helyi időként értelmeződnek. Az UTC-időként való értelmezés egy történelmi specifikációs hiba miatt van, amely nem volt összhangban az ISO 8601-gyel, de a webes kompatibilitás miatt nem lehetett megváltoztatni. Lásd: Broken Parser – A Web Reality Issue.

Date objektum

Egy meglévő dátumobjektum is használható konstruktorargumentumként. Ez lemásolja a meglévő Date objektumot ugyanazzal a dátummal és idővel.

const t1 = new Date();
const t2 = new Date(t1);
// Values of t1 and t2 will be the same.

Az egyes dátum- és időösszetevők értékeinek megadása

Egy dátumot képviselő dátumobjektumot három szám átadásával hozhatsz létre. Egy dátumot és időt képviselőt hat szám átadásával hozhatsz létre.

const date1 = new Date(95, 11, 17);
// Creates Date for Dec 17 1995 00:00 if your local timezone is equivalent to UTC.

const date2 = new Date(2013, 12, 5, 13, 24, 0);
// Creates Date for Jan 5 2014 13:24 if your local timezone is equivalent to UTC.

A második érték a month, amely januárban 0-tól indul, decemberben pedig 11-ig tart.

Date.parse()

Találkozhatsz egy Date.parse nevű dátumfeldolgozó függvény említésével vagy rá mutató hivatkozással. Mivel ennek a függvénynek csak néhány invariánsa (igazsága) van, a többi része pedig nincs specifikálva (és így nem szabványos), nem érdemes használni.

A Date összetevőinek elérése

A dátumobjektumokon több olyan metódus is van, amely visszaadja a dátum összetevőit:

getFullYear(); // Get the year (4 digits)
getMonth(); // Get the month, from 0 to 11.
getDate(); // Get the day of month, from 1 to 31.
getHours(); // Get the hour in a 24 clock, from 0 to 23
getMinutes(); // Get the minutes, from 0 to 59
getSeconds(); // Get the seconds, from 0 to 59
getMilliseconds(); // Get the milliseconds, from 0 and 999
getDay(); // Get the day of week, from 0 (Sunday) to 6 (Saturday).

Mindegyiknek van egy megfelelő set változata (például setFullYear), amellyel frissítheted az értéket. A túlcsorduló érték átfordul a következő összetevőre:

const date = new Date('2025-02-28T12:42:00Z');
// => Fri Feb 28 2025 13:42:00 GMT+0100 (Central European Standard Time)

date.setDate(29);
// there was no February 29th in 2025.

date.getDate();
// => 1

date.toString();
// => Sat Mar 01 2025 13:42:00 GMT+0100 (Central European Standard Time)

Minden metódusnak van UTC-változata, amely figyelmen kívül hagyja a helyi időzónát.

Konvertálás dátumból

A dátumobjektumoknak van egy getTime() metódusuk, amely az UNIX timestampet adja vissza ezredmásodpercben, azaz az 1970. január 1-jei éjfél (UTC) óta eltelt ezredmásodpercek számát. Emellett a toISOString() metódussal egy dátumobjektumot ISO 8601 timestamp stringgé konvertálhatsz.

Dátumok összehasonlítása

A nagyobb mint (>), a nagyobb vagy egyenlő (>=), valamint a kisebb mint (<) és a kisebb vagy egyenlő (<=) operátorok közvetlenül használhatók két dátum között, vagy egy dátum és egy szám között. Ez azért működik, mert a JavaScript automatikus típuskonverzióval primitívre próbálja alakítani a dátumot.

A dátumok nem hasonlíthatók össze egyenlőséggel (== és ===), de a .getTime() eredménye igen.