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
- ECMAScript® 2024 Language Specification — Date.prototype.getUTCFullYear
- ECMAScript® 2024 Language Specification — Date.prototype.setUTCFullYear
- ECMAScript® 2024 Language Specification — Date.UTC
- ECMAScript® 2024 Language Specification — TimeClip
- Date.prototype.getUTCFullYear() - JavaScript | MDN
- Date.prototype.setUTCFullYear() - JavaScript | MDN