CKTIS / JavaScript
Date.prototype.toJSON: Date nella serializzazione JSON
toJSON restituisce testo ISO per una data valida, null per una non valida ed è invocato automaticamente da JSON.stringify.
Versione: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2
Sintassi
date.toJSON(key)date.toJSON(key) normalmente restituisce la stessa stringa di date.toISOString(). JSON.stringify lo chiama con la chiave della proprietà, ma l’algoritmo standard non usa key. Per un Date non valido la conversione numerica non è finita, quindi restituisce null invece del RangeError di toISOString().
Il metodo è volutamente generico: ottiene prima un primitivo con hint number. Solo se è un Number non finito restituisce null; altrimenti invoca la proprietà toISOString del receiver. Può quindi funzionare su un oggetto non Date. Genera se la conversione genera o se toISOString non è invocabile o genera.
JSON conserva l’istante come testo UTC ma perde il tipo Date; dopo il parsing si ha una stringa. È standard da ECMAScript 5 (2009).
Esempi
const payload = {
when: new Date("2024-01-02T03:04:05.006Z"),
missing: new Date(NaN),
};
console.log(JSON.stringify(payload));
console.log(payload.when.toJSON());
const custom = {valueOf: () => 0, toISOString: () => "custom-time"};
console.log(Date.prototype.toJSON.call(custom));Risultato
{"when":"2024-01-02T03:04:05.006Z","missing":null}
2024-01-02T03:04:05.006Z
custom-time