Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Date.prototype.toJSON: Date v serializaciji JSON

toJSON vrne besedilo ISO za veljaven datum, null za neveljavnega in ga JSON.stringify pokliče samodejno.

Različica: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2

Sintaksa

date.toJSON(key)

date.toJSON(key) navadno vrne isti niz kot date.toISOString(). JSON.stringify ga pokliče s ključem lastnosti, vendar standardni algoritem argumenta key ne uporablja. Pri neveljavnem Date številska pretvorba ni končna, zato vrne null namesto RangeError iz toISOString().

Metoda je namenoma generična: najprej pridobi primitiv s hintom number. Le če je to Number, ki ni končen, vrne null; sicer pokliče lastnost toISOString receiverja. Zato lahko deluje na objektu, ki ni Date. Sproži izjemo, če jo pretvorba sproži ali toISOString ni klicljiv oziroma sproži.

JSON ohrani trenutek kot besedilo UTC, izgubi pa tip Date; po branju dobimo niz. Metoda je standardna od ECMAScript 5 (2009).

Primeri

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

Viri