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

CKTIS / JavaScript

Date.prototype.toISOString: kanonický text UTC

toISOString vracia kanonický text dátumu a času v UTC s milisekundami a koncovým Z.

Verzia: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2

Syntax

date.toISOString()

date.toISOString() vracia zjednodušený formát ISO 8601 v UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Bežné roky majú 24 znakov; mimo 0000–9999 sa použije znamienko a šesť číslic, spolu 27. Metóda nepoužíva miestne pásmo a objekt nemení.

Pre neplatný Date alebo rok, ktorý nemožno v požadovanom formáte vyjadriť, vyvolá RangeError; nevracia "Invalid Date". Receiver bez interného stavu Date vyvolá TypeError. Metóda nemá argumenty a ďalšie ignoruje.

Formát je vhodný na výmenu dát a Date.parse ho znovu načíta. Nezachováva názov pásma ani pôvodný offset, len rovnaký okamih v UTC. Metóda je štandardná od ECMAScript 5 (2009).

Príklady

const date = new Date(Date.UTC(2024, 1, 29, 12, 34, 56, 789));
console.log(date.toISOString());
console.log(new Date(-1).toISOString());
try { new Date(NaN).toISOString(); } catch (error) { console.log(error instanceof RangeError); }

Výsledok

2024-02-29T12:34:56.789Z
1969-12-31T23:59:59.999Z
true

Zdroje