Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Branje in spreminjanje leta UTC v objektu Date

`getUTCFullYear()` prebere leto v UTC. `setUTCFullYear()` spremeni isti objekt `Date` in vrne nov časovni žig. Izpustiti argument ni isto kot podati `undefined`.

Različica: 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 sprejme argumentov in vrne koledarsko leto v UTC kot celo število, ne kot štirimestni niz. Če datum ni veljaven, vrne NaN. Metodi getFullYear() in setFullYear() pa uporabljata krajevni časovni pas izvajalnega okolja. Ob prehodu v novo leto lahko isti trenutek v UTC in v krajevnem času pripada različnima letoma.

setUTCFullYear(year, monthIndex, dayOfMonth) spremeni obstoječi objekt Date in vrne nov časovni žig v milisekundah od začetka epohe Unix. Leto je obvezno. Neobvezni indeks meseca sega od 0 (januar) do 11 (december), dnevi v mesecu pa se štejejo od 1. Če podaš dan, moraš podati tudi mesec. Izpuščene sestavine in čas dneva se prevzamejo iz obstoječega datuma v UTC. Vrednosti zunaj običajnega razpona se normalizirajo: 29. februar postane 1. marec ob prehodu v neprestopno leto.

Argumenti se pretvorijo v števila. Izrecno podani undefined ni enak izpuščenemu argumentu: pretvori se v NaN. Če se argument pretvori v NaN ali je nov časovni žig zunaj obsega Date, metoda shrani in vrne NaN. Če je bil datum že neveljaven, metoda izhaja iz 1970-01-01T00:00:00.000Z, zato ga lahko veljaven klic popravi.

V nasprotju z Date.UTC() metoda setUTCFullYear() letom od 0 do 99 ne prišteje 1900. Obe metodi prototipa zahtevata pravi objekt Date kot this; klic z neustreznim this sproži TypeError.

Primeri

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

Ob spremembi leta na 2023 se 29. februar premakne na 1. marec, čas dneva v UTC pa ostane isti. Izrecno podani `undefined` razveljavi datum; nastavitev leta na `7` znova vzpostavi veljaven datum: 1. januar leta 7 ob polnoči UTC.

Povezane lekcije

  • JavaScript · Lekcija 5 · Napredna · Različica: 4

Viri