CKTIS / JavaScript
Date.prototype.toJSON: Date in JSON-serialisatie
toJSON geeft ISO-tekst voor een geldige datum, null voor een ongeldige en wordt automatisch door JSON.stringify aangeroepen.
Versie: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2
Syntax
date.toJSON(key)date.toJSON(key) geeft normaal dezelfde tekenreeks als date.toISOString(). JSON.stringify roept haar aan met de eigenschapssleutel, maar het standaardalgoritme gebruikt key niet. Voor een ongeldige Date is numerieke omzetting niet eindig, zodat null volgt in plaats van de RangeError van toISOString().
De methode is opzettelijk generiek: ze verkrijgt eerst een primitief met number-hint. Alleen als dit een niet-eindige Number is geeft ze null; anders roept ze de eigenschap toISOString van de receiver aan. Ze kan dus op een niet-Date-object werken. Ze werpt als omzetting werpt of toISOString niet aanroepbaar is of werpt.
JSON bewaart het tijdstip als UTC-tekst maar verliest het Date-type; na parsen blijft een string over. De methode is standaard sinds ECMAScript 5 (2009).
Voorbeelden
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));Resultaat
{"when":"2024-01-02T03:04:05.006Z","missing":null}
2024-01-02T03:04:05.006Z
custom-time