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