CKTIS / JavaScript
Date.prototype.toISOString: kanonický text UTC
toISOString vrací kanonický text data a času v UTC s milisekundami a koncovým Z.
Verze: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2
Syntaxe
date.toISOString()date.toISOString() vrací zjednodušený formát ISO 8601 v UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Běžné roky mají 24 znaků; mimo 0000–9999 se použije znaménko a šest číslic, celkem 27. Metoda nepoužívá místní pásmo a objekt nemění.
Pro neplatný Date nebo rok, který nelze v požadovaném formátu vyjádřit, vyvolá RangeError; nevrací "Invalid Date". Receiver bez interního stavu Date vyvolá TypeError. Metoda nemá argumenty a další ignoruje.
Formát je vhodný pro výměnu dat a Date.parse jej znovu načte. Nezachovává název pásma ani původní offset, jen stejný okamžik v UTC. Metoda je standardní od ECMAScript 5 (2009).
Pří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ýsledek
2024-02-29T12:34:56.789Z 1969-12-31T23:59:59.999Z true