CKTIS / JavaScript
Date.prototype.toJSON: Date u JSON serijalizaciji
toJSON vraća ISO tekst za valjani datum, null za nevaljani i JSON.stringify ga poziva automatski.
Verzija: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2
Sintaksa
date.toJSON(key)date.toJSON(key) obično vraća isti niz kao date.toISOString(). JSON.stringify ga poziva s ključem svojstva, ali standardni algoritam ne koristi key. Za nevaljani Date brojčana pretvorba nije konačna, pa metoda vraća null umjesto RangeError iz toISOString().
Metoda je namjerno generička: najprije dobiva primitiv s hintom number. Samo ako je to Number koji nije konačan vraća null; inače poziva svojstvo toISOString receivera. Zato može raditi na objektu koji nije Date. Baca ako pretvorba baca ili toISOString nije pozivljiv ili baca.
JSON čuva trenutak kao UTC tekst, ali gubi tip Date; nakon čitanja dobiva se string. Metoda je standardna od ECMAScript 5 (2009).
Primjeri
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));Rezultat
{"when":"2024-01-02T03:04:05.006Z","missing":null}
2024-01-02T03:04:05.006Z
custom-time