Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Čitanje i promjena godine u UTC-u na objektu Date

`getUTCFullYear()` čita godinu u UTC-u. `setUTCFullYear()` mijenja isti objekt `Date` i vraća novu vremensku oznaku. Izostavljanje argumenta nije isto što i prosljeđivanje vrijednosti `undefined`.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

date.getUTCFullYear()
date.setUTCFullYear(year)
date.setUTCFullYear(year, monthIndex)
date.setUTCFullYear(year, monthIndex, dayOfMonth)

getUTCFullYear() ne prima argumente i vraća kalendarsku godinu u UTC-u kao cijeli broj, a ne kao četveroznamenkasti niz znakova. Za nevaljan datum vraća NaN. Nasuprot tome, getFullYear() i setFullYear() koriste lokalnu vremensku zonu izvršnog okruženja. Na prijelazu u novu godinu isti trenutak može pripadati različitim godinama u UTC-u i po lokalnom vremenu.

setUTCFullYear(year, monthIndex, dayOfMonth) mijenja postojeći objekt Date i vraća novu vremensku oznaku u milisekundama od početka Unixove epohe. Godina je obvezna. Neobvezni indeks mjeseca ide od 0 (siječanj) do 11 (prosinac), a dan u mjesecu broji se od 1. Ako navedeš dan, moraš navesti i mjesec. Izostavljene sastavnice i doba dana preuzimaju se iz postojećeg datuma u UTC-u. Vrijednosti izvan uobičajenog raspona normaliziraju se: 29. veljače postaje 1. ožujka pri promjeni u neprijestupnu godinu.

Argumenti se pretvaraju u brojeve. Izričito zadani undefined nije izostavljeni argument: pretvara se u NaN. Ako se argument pretvori u NaN ili je dobivena vremenska oznaka izvan raspona objekta Date, metoda pohranjuje i vraća NaN. Ako je datum već bio nevaljan, metoda polazi od 1970-01-01T00:00:00.000Z, pa ga valjan poziv može popraviti.

Za razliku od Date.UTC(), setUTCFullYear() godinama od 0 do 99 ne pribraja 1900. Obje metode prototipa zahtijevaju da this bude stvarni objekt Date; poziv s neodgovarajućom vrijednošću this izaziva TypeError.

Primjeri

const date = new Date('2024-02-29T12:34:56.789Z');
console.log(date.getUTCFullYear());
console.log(date.setUTCFullYear(2023));
console.log(date.toISOString());
console.log(date.setUTCFullYear(2023, undefined));
console.log(date.getUTCFullYear());
date.setUTCFullYear(7);
console.log(date.toISOString());

Rezultat

2024
1677674096789
2023-03-01T12:34:56.789Z
NaN
NaN
0007-01-01T00:00:00.000Z

Pri promjeni godine na 2023., 29. veljače prelazi u 1. ožujka, a doba dana u UTC-u ostaje isto. Izričito zadani `undefined` čini datum nevaljanim; postavljanje godine na `7` vraća valjan datum: 1. siječnja godine 7 u ponoć po UTC-u.

Povezane lekcije

  • JavaScript · Lekcija 5 · Napredno · Verzija: 4

Izvori