CKTIS / JavaScript
Date — časové značky a rok v UTC
Date ukladá časovú značku. Naučte sa čítať a meniť rok v UTC, pochopiť zmenu objektu a normalizáciu dátumu vrátane posunu 29. februára v neprestupnom roku na 1. marec.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])Date je vstavaný objekt ECMAScriptu, ktorý ukladá počet milisekúnd od 1970-01-01T00:00:00.000Z, alebo NaN pre neplatný dátum. Časové pásmo neukladá. Lokálne metódy interpretujú tú istú časovú značku podľa časového pásma prostredia; metódy UTC používajú UTC.
Date.prototype.getUTCFullYear() vracia celý rok v UTC, alebo NaN pre neplatný dátum. Date.prototype.setUTCFullYear(year[, month[, day]]) zmení objekt a vráti výslednú časovú značku, nie objekt Date. Mesiace používajú indexy 0–11, zatiaľ čo dni v mesiaci sa začínajú hodnotou 1. Ak je pôvodný dátum platný, pre každý vynechaný argument mesiaca alebo dňa použije metóda ako vstup pôvodnú hodnotu v UTC. Normalizácia môže vo výsledku zmeniť mesiac aj deň. Ak je výsledok platný, čas v rámci dňa v UTC sa nezmení.
Setter normalizuje hodnoty: zmena roka pri 29. februári na neprestupný rok vedie k 1. marcu. Rok v rozsahu 0–99 sa interpretuje doslovne, na rozdiel od konštruktora Date s viacerými argumentmi. Pri neplatnom dátume použije setter ako východiskový bod časovú značku 0; neplatné číselné argumenty však stále môžu viesť k NaN.
Príklad používa explicitné Z a metódy UTC, takže výsledok nezávisí od miestneho časového pásma. Overuje aj to, že vrátená časová značka zodpovedá zmenenému objektu.
Prí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ýsledok
2024 2025-03-01T12:00:00.000Z true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.