WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Date.prototype.toISOString: kanonischer UTC-Text

toISOString liefert kanonischen UTC-Datum-Zeit-Text mit Millisekunden und abschließendem Z.

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

Syntax

date.toISOString()

date.toISOString() liefert das vereinfachte ISO-8601-Format in UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Übliche Jahre ergeben 24 Zeichen; Jahre außerhalb 0000–9999 nutzen Vorzeichen und sechs Ziffern und ergeben 27. Die Methode verwendet keine lokale Zeitzone und verändert das Objekt nicht.

Bei einem ungültigen Date oder einem nicht im geforderten Format darstellbaren Jahr löst sie RangeError aus; sie liefert nicht "Invalid Date". Ein Receiver ohne internen Date-Zustand führt zu TypeError. Die Methode hat keine Argumente, zusätzliche werden ignoriert.

Das Format eignet sich zum Datenaustausch und kann von Date.parse erneut gelesen werden. Es bewahrt weder Zonenname noch ursprünglichen Offset, sondern denselben Zeitpunkt in UTC. Die Methode ist seit ECMAScript 5 (2009) standardisiert.

Beispiele

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

Ergebnis

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

Quellen