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