Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Čtení a změna roku v UTC u objektu Date

`getUTCFullYear()` čte rok v UTC. `setUTCFullYear()` mění tentýž objekt `Date` a vrací jeho nové časové razítko. Vynechat argument není totéž jako předat `undefined`.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

date.getUTCFullYear()
date.setUTCFullYear(year)
date.setUTCFullYear(year, monthIndex)
date.setUTCFullYear(year, monthIndex, dayOfMonth)

getUTCFullYear() nepřijímá žádné argumenty a vrací kalendářní rok v UTC jako celé číslo, nikoli jako čtyřmístný řetězec. Pro neplatné datum vrací NaN. Naproti tomu getFullYear() a setFullYear() pracují v místním časovém pásmu běhového prostředí. Na přelomu roku tak může tentýž okamžik spadat v UTC a v místním čase do různých let.

setUTCFullYear(year, monthIndex, dayOfMonth) změní stávající objekt Date a vrátí nové časové razítko v milisekundách od unixové epochy. Rok je povinný. Volitelný index měsíce je od 0 (leden) do 11 (prosinec) a den v měsíci se počítá od 1. Chcete-li zadat den, musíte zadat i měsíc. Vynechané složky i denní čas se převezmou ze stávajícího data v UTC. Hodnoty mimo běžný rozsah se normalizují: při změně na nepřestupný rok se z 29. února stane 1. březen.

Argumenty se převádějí na čísla. Výslovné undefined neznamená vynechání argumentu: převede se na NaN. Pokud se argument převede na NaN nebo výsledné časové razítko leží mimo rozsah Date, metoda uloží a vrátí NaN. Pokud už bylo datum neplatné, výchozí hodnotou je 1970-01-01T00:00:00.000Z, takže platné volání ho může opravit.

Na rozdíl od Date.UTC() metoda setUTCFullYear() nepřičítá k rokům od 0 do 99 hodnotu 1900. Obě metody prototypu vyžadují skutečný objekt Date jako this; volání s nevyhovující hodnotou this vyvolá TypeError.

Pří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ýsledek

2024
1677674096789
2023-03-01T12:34:56.789Z
NaN
NaN
0007-01-01T00:00:00.000Z

Při změně roku na 2023 se 29. únor posune na 1. březen, ale denní čas v UTC zůstane stejný. Výslovné `undefined` zneplatní datum; nastavení roku na `7` obnoví platné datum: 1. ledna roku 7 o půlnoci UTC.

Související lekce

  • JavaScript · Lekce 5 · Pokročilá · Verze: 4

Zdroje