KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen