Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori