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

CKTIS / JavaScript

Date — časová razítka a rok v UTC

Date ukládá časové razítko. Naučte se číst a měnit rok v UTC, pochopit změnu objektu a normalizaci data, včetně posunu 29. února v nepřestupném roce na 1. března.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])

Date je vestavěný objekt ECMAScriptu, který ukládá počet milisekund od 1970-01-01T00:00:00.000Z, nebo NaN pro neplatné datum. Časové pásmo neukládá. Lokální metody interpretují stejné časové razítko podle časového pásma prostředí; metody UTC používají UTC.

Date.prototype.getUTCFullYear() vrací celý rok v UTC, nebo NaN pro neplatné datum. Date.prototype.setUTCFullYear(year[, month[, day]]) změní objekt a vrátí výsledné časové razítko, nikoli objekt Date. Měsíce používají indexy 0–11, zatímco dny v měsíci začínají hodnotou 1. Je-li původní datum platné, pro každý vynechaný argument měsíce nebo dne použije metoda jako vstup původní hodnotu v UTC. Normalizace může ve výsledku změnit měsíc i den. Je-li výsledek platný, čas v rámci dne v UTC se nezmění.

Setter normalizuje hodnoty: změna roku u 29. února na nepřestupný rok vede k 1. březnu. Rok v rozsahu 0–99 se interpretuje doslova, na rozdíl od konstruktoru Date s více argumenty. U neplatného data použije setter jako výchozí bod časové razítko 0; neplatné číselné argumenty však stále mohou vést k NaN.

Příklad používá explicitní Z a metody UTC, takže výsledek nezávisí na místním časovém pásmu. Ověřuje také, že vrácené časové razítko odpovídá změněnému objektu.

Příklady

const date = new Date("2024-02-29T12:00:00.000Z");
console.log(date.getUTCFullYear());
const timestamp = date.setUTCFullYear(2025);
console.log(date.toISOString());
console.log(timestamp === date.getTime());

Výsledek

2024
2025-03-01T12:00:00.000Z
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje