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