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
- 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