CKTIS / JavaScript
Date.prototype.toISOString: testo UTC canonico
toISOString restituisce testo date-time UTC canonico con millisecondi e Z finale.
Versione: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2
Sintassi
date.toISOString()date.toISOString() restituisce il formato ISO 8601 semplificato in UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Gli anni normali producono 24 caratteri; fuori da 0000–9999 usa segno e sei cifre, producendo 27. Il metodo non usa il fuso locale e non modifica l’oggetto.
Per un Date non valido o un anno non rappresentabile nel formato richiesto genera RangeError; non restituisce "Invalid Date". Un receiver senza stato interno Date genera TypeError. Il metodo non accetta argomenti e quelli aggiuntivi sono ignorati.
Il formato è adatto allo scambio dati e può essere riletto da Date.parse. Non conserva nome del fuso né offset originale, solo lo stesso istante espresso in UTC. È standard da ECMAScript 5 (2009).
Esempi
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); }Risultato
2024-02-29T12:34:56.789Z 1969-12-31T23:59:59.999Z true