Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Date.prototype.toISOString: kanonično besedilo UTC

toISOString vrne kanonično besedilo datuma in časa v UTC z milisekundami in končnim Z.

Različica: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2

Sintaksa

date.toISOString()

date.toISOString() vrne poenostavljen format ISO 8601 v UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Običajna leta imajo 24 znakov; zunaj 0000–9999 se uporabita predznak in šest števk, skupaj 27. Metoda ne uporablja krajevnega pasu in objekta ne spremeni.

Za neveljaven Date ali leto, ki ga ni mogoče predstaviti v zahtevanem formatu, sproži RangeError; ne vrne "Invalid Date". Receiver brez notranjega stanja Date sproži TypeError. Metoda nima argumentov in dodatne prezre.

Format je primeren za izmenjavo podatkov in ga Date.parse znova prebere. Ne ohrani imena pasu ali prvotnega odmika, le isti trenutek v UTC. Metoda je standardna od ECMAScript 5 (2009).

Primeri

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); }

Rezultat

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

Viri