CKTIS / JavaScript
Date.prototype.toJSON : Date dans la sérialisation JSON
toJSON renvoie le texte ISO d’une date valide, null pour une date invalide et est appelée automatiquement par JSON.stringify.
Version : ECMAScript 5 (2009) onward; example target: Node.js 24.22.2
Syntaxe
date.toJSON(key)date.toJSON(key) renvoie normalement la même chaîne que date.toISOString(). JSON.stringify l’appelle avec la clé de propriété, mais l’algorithme standard n’utilise pas key. Pour un Date invalide, la conversion numérique n’est pas finie, donc la méthode renvoie null au lieu de lever le RangeError de toISOString().
La méthode est volontairement générique : elle obtient d’abord une primitive avec l’indice number. Seulement si c’est un Number non fini, elle renvoie null ; sinon elle invoque la propriété toISOString du receiver. Elle peut donc fonctionner sur un objet non Date. Elle lève si la conversion lève, ou si toISOString n’est pas appelable ou lève.
JSON conserve l’instant en texte UTC mais perd le type Date ; après analyse, on obtient une chaîne. La méthode est standard depuis ECMAScript 5 (2009).
Exemples
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));Résultat
{"when":"2024-01-02T03:04:05.006Z","missing":null}
2024-01-02T03:04:05.006Z
custom-time