CKTIS / JavaScript
Čítanie a zmena roka v UTC v objekte Date
`getUTCFullYear()` číta rok v UTC. `setUTCFullYear()` mení ten istý objekt `Date` a vracia jeho novú časovú pečiatku. Vynechať argument nie je to isté ako odovzdať `undefined`.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
date.getUTCFullYear()
date.setUTCFullYear(year)
date.setUTCFullYear(year, monthIndex)
date.setUTCFullYear(year, monthIndex, dayOfMonth)getUTCFullYear() neprijíma žiadne argumenty a vracia kalendárny rok v UTC ako celé číslo, nie ako štvorciferný reťazec. Pri neplatnom dátume vracia NaN. Naopak, getFullYear() a setFullYear() používajú miestne časové pásmo prostredia, v ktorom sa kód vykonáva. Na prelome rokov tak môže ten istý okamih patriť v UTC do iného roka ako v miestnom čase.
setUTCFullYear(year, monthIndex, dayOfMonth) zmení existujúci objekt Date a vráti novú časovú pečiatku v milisekundách od unixovej epochy. Rok je povinný. Voliteľný index mesiaca je od 0 (január) do 11 (december) a deň v mesiaci sa počíta od 1. Ak zadáš deň, musíš zadať aj mesiac. Vynechané zložky aj čas dňa sa prevezmú z pôvodného dátumu v UTC. Hodnoty mimo bežného rozsahu sa normalizujú: pri zmene na nepriestupný rok sa z 29. februára stane 1. marec.
Argumenty sa prevádzajú na čísla. Výslovne odovzdané undefined nie je vynechanie argumentu: prevedie sa na NaN. Ak sa argument prevedie na NaN alebo výsledná časová pečiatka leží mimo rozsahu Date, metóda uloží a vráti NaN. Ak bol dátum už neplatný, východiskom je 1970-01-01T00:00:00.000Z, takže platné volanie ho môže opraviť.
Na rozdiel od Date.UTC() metóda setUTCFullYear() nepripočítava k rokom od 0 do 99 hodnotu 1900. Obe metódy prototypu vyžadujú skutočný objekt Date ako this; volanie s nevyhovujúcou hodnotou this vyvolá TypeError.
Príklady
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());Výsledok
2024 1677674096789 2023-03-01T12:34:56.789Z NaN NaN 0007-01-01T00:00:00.000Z
Pri zmene roka na 2023 sa 29. február posunie na 1. marec bez zmeny času dňa v UTC. Výslovne odovzdané `undefined` zneplatní dátum; nastavenie roka na `7` obnoví platný dátum: 1. januára roka 7 o polnoci UTC.
Súvisiace lekcie
- JavaScript · Lekcia 5 · Pokročilá · Verzia: 4
Zdroje
- 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