Objekta Date in Temporal

Objekt Date v JavaScriptu omogoča delo z datumom in časom. Vsak objekt Date v ozadju predstavlja določen trenutek kot število milisekund, ki so pretekle od 1. januarja 1970 ob 00:00:00 po času UTC. Na podlagi te vrednosti lahko pridobivamo ali nastavljamo leto, mesec, dan, uro, minute, sekunde in milisekunde.

Osnovna pravila

• Objekt Date predstavlja trenutek v času.
• Osnovna številska vrednost objekta Date je število milisekund od 1. januarja 1970 po času UTC.
• Za isti trenutek lahko dobimo lokalni ali UTC prikaz časa.
• Pri konstruktorju new Date(leto, mesec, ...) so meseci oštevilčeni od 0 do 11.
• Pri razčlenjevanju nizov je praviloma najzanesljivejši standardni zapis datuma.

Primerjave

Osnovno o objektu Date

Objekt Date lahko izpišemo kot besedilo ali pa pridobimo njegovo številsko vrednost z metodo getTime(). Obe predstavitvi se nanašata na isti trenutek.

Čas v JavaScriptu lahko izpišemo kot niz:

ali kot število milisekund:

Ustvarjanje datuma

Objekt Date ustvarimo s konstruktorjem new Date(). Najpogostejši načini so ustvarjanje trenutnega časa, ustvarjanje iz števila milisekund, iz niza ali iz posameznih številskih delov datuma.

<p id="primer3"></p>
<script>
{
   const a = new Date();
   const b = new Date(0);
   const c = new Date("2025-05-09");
   const e = new Date(2025, 4, 9);

   document.getElementById("primer3").innerHTML =
      a + "<br>" +
      b + "<br>" +
      c + "<br>" +
      e;
}
</script>

Metode get...

Metode get... uporabimo za pridobivanje posameznih delov datuma po lokalnem času.

Metoda getDay()

Metoda getDay() vrne številko dneva v tednu po lokalnem času. Če želimo ime dneva, lahko uporabimo tabelo z imeni dni.

<p id="primer4"></p>
<script>
{
   const d = new Date();
   const dnevi = ["Nedelja", "Ponedeljek", "Torek", "Sreda", "Četrtek", "Petek", "Sobota"];
   document.getElementById("primer4").textContent = dnevi[d.getDay()];
}
</script>

Metoda getFullYear()

Metoda getFullYear() vrne neokrajšano letnico po lokalnem času.

<p id="primer5"></p>
<script>
{
   const d = new Date();
   document.getElementById("primer5").textContent = d.getFullYear();
}
</script>

Metoda getTime()

Metoda getTime() vrne število milisekund od začetnega referenčnega trenutka.

<p id="primer6"></p>
<script>
{
   const d = new Date();
   document.getElementById("primer6").textContent = d.getTime();
}
</script>

Metode set...

Metode set... uporabimo za spreminjanje objekta Date. Tako lahko nastavimo posamezne dele datuma ali pa datum premikamo naprej in nazaj.

Metoda setFullYear()

Metoda setFullYear() spremeni letnico po lokalnem času.

<p id="primer7"></p>
<script>
{
   const d = new Date();
   d.setFullYear(2010, 8, 11);
   document.getElementById("primer7").textContent = d;
}
</script>

Metoda setDate()

Metodo setDate() lahko uporabimo tudi za dodajanje ali odštevanje dni.

<p id="primer8"></p>
<script>
{
   const d = new Date();
   d.setDate(d.getDate() + 20);
   document.getElementById("primer8").textContent = d;
}
</script>

UTC in lokalni čas

Objekt Date omogoča delo z lokalnim časom in z UTC. Zato poleg metod, kot je getHours(), obstajajo tudi metode, kot je getUTCHours(). Razlika med obema pristopoma je v časovnem pasu, ki ga uporabimo za prikaz istega trenutka.

<p id="primer9"></p>
<script>
{
   const d = new Date();
   document.getElementById("primer9").innerHTML =
      "Lokalna ura: " + d.getHours() + "<br>" +
      "UTC ura: " + d.getUTCHours();
}
</script>

Zapisi datumov

Za izpis datuma v standardni obliki pogosto uporabljamo toISOString(), ki vrne zapis v poenostavljenem formatu ISO 8601 in vedno v času UTC. Za prikaz uporabniku pa pogosto uporabimo toLocaleString(), ki upošteva jezikovne in krajevne nastavitve okolja.

<p id="primer10"></p>
<script>
{
   const d = new Date("2025-05-09T14:30:00Z");
   document.getElementById("primer10").innerHTML =
      d.toISOString() + "<br>" +
      d.toLocaleString();
}
</script>

Temporal

Objekt Temporal je sodobnejši API za delo z datumom in časom v JavaScriptu. Zasnovan je kot celovitejša in preglednejša zamenjava za objekt Date. Temporal loči med različnimi vrstami časovnih podatkov, na primer med datumom brez časa, časom brez časovnega pasu, natančnim trenutkom in datumom s časovnim pasom. Takšna razdelitev zmanjša možnost napak, ki pri objektu Date pogosto nastanejo zaradi mešanja lokalnega časa, časa UTC in nizov različnih oblik.

Za pridobivanje trenutnega časa Temporal uporablja prostor imen Temporal.Now. Ta vsebuje metode za pridobivanje trenutnega datuma, časa ali natančnega trenutka v različnih oblikah.

Temporal je posebej uporaben v primerih, ko potrebujemo jasno ločevanje med različnimi vrstami časovnih podatkov. Če želimo na primer predstaviti koledarski datum rojstva, je primeren Temporal.PlainDate. Če želimo predstaviti natančen trenutek, ko je bilo nekaj objavljeno na strežniku, je primeren Temporal.Instant. Če želimo delati z datumom in uro v določenem časovnem pasu, je primeren Temporal.ZonedDateTime.

Primer Temporal.PlainDate

Objekt Temporal.PlainDate uporabimo, kadar potrebujemo samo datum brez ure in brez časovnega pasu.

<p id="primer11"></p>
<script>
{
   const datum = Temporal.PlainDate.from("2025-05-09");
   document.getElementById("primer11").textContent =
      datum.year + "-" + datum.month + "-" + datum.day;
}
</script>

Primer Temporal.Now in Temporal.Instant

Objekt Temporal.Instant predstavlja natančen trenutek v času. Pridobimo ga lahko tudi prek prostora imen Temporal.Now.

<p id="primer12"></p>
<script>
{
   const trenutek = Temporal.Now.instant();
   document.getElementById("primer12").textContent = trenutek.toString();
}
</script>

Primer Temporal.ZonedDateTime

Objekt Temporal.ZonedDateTime uporabimo, kadar želimo poleg datuma in ure ohraniti tudi časovni pas. Ta tip je posebej uporaben pri pravilnem računanju čez prehode med poletnim in zimskim časom.

<p id="primer13"></p>
<script>
{
   const zdt = Temporal.ZonedDateTime.from("2025-05-09T14:30:00+02:00[Europe/Ljubljana]");
   document.getElementById("primer13").textContent = zdt.toString();
}
</script>

Date in Temporal

Objekt Date je še vedno zelo razširjen, vendar je Temporal zasnovan kot preglednejši sodobni API za novo kodo. Temporal jasneje loči med različnimi vrstami datumov in časov, vključuje podporo za časovne pasove in zmanjšuje pogoste napake pri delu z datumom in časom.

Priporočila

• Pri številskem konstruktorju new Date(leto, mesec, ...) vedno upoštevaj, da se meseci začnejo pri 0.
• Pri delu z mednarodnimi datumi in izmenjavo podatkov pogosto uporabi toISOString().
• Za uporabniški prikaz datuma pogosto uporabi toLocaleString() ali sorodne krajevno prilagojene metode.
• Pri računanju razlik ali primerjavi datumov pogosto uporabi getTime().
• Pri razčlenjevanju nizov praviloma uporabi standardni zapis datuma.
• Za novo kodo, kadar je podpora okolja ustrezna, razmisli o uporabi Temporal namesto objekta Date.

Pogoste napake

• Mesec pri konstruktorju new Date(leto, mesec, dan) se razume kot vrednost od 1 do 12, čeprav JavaScript pričakuje vrednost od 0 do 11.
• Metodi getDay() in getDate() se obravnavata kot enakovredni, čeprav prva vrne dan v tednu, druga pa dan v mesecu.
• Lokalni čas in UTC se mešata brez jasne razlage, kar povzroči nejasne rezultate pri urah ali datumih.
• Pri razčlenjevanju datumov se uporabljajo nestandardni nizi, ki niso enako zanesljivi v vseh okoljih.
• Objekt Date se uporablja kot sodoben celovit API za vse vrste datumov in časov, čeprav ima več zgodovinskih omejitev in je za novejše primere uporabe zasnovan API Temporal.
• Objekt Date se uporablja tudi tam, kjer bi bil zaradi jasnejšega pomena primernejši Temporal.PlainDate, Temporal.Instant ali Temporal.ZonedDateTime.
• Pred uporabo objekta Temporal se ne preveri podpora okolja, čeprav ta API še ni enako široko razširjen kot objekt Date.