Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti