Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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