CKTIS / JavaScript
Date.prototype.toJSON: Date en serialización JSON
toJSON devuelve texto ISO para una fecha válida, null para una inválida y JSON.stringify la invoca automáticamente.
Versión: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2
Sintaxis
date.toJSON(key)date.toJSON(key) suele devolver la misma cadena que date.toISOString(). JSON.stringify la llama con la clave de propiedad, pero el algoritmo estándar no usa key. Para un Date inválido, la conversión numérica no es finita, así que devuelve null en lugar de lanzar el RangeError de toISOString().
El método es deliberadamente genérico: primero obtiene un primitivo con hint number. Solo si es un Number no finito devuelve null; en otro caso invoca la propiedad toISOString del receptor. Por ello puede funcionar con un objeto no Date. Lanza si la conversión lanza o si toISOString no es invocable o lanza.
JSON conserva el instante como texto UTC pero pierde el tipo Date; al analizar se obtiene un string. Es estándar desde ECMAScript 5 (2009).
Ejemplos
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));Resultado
{"when":"2024-01-02T03:04:05.006Z","missing":null}
2024-01-02T03:04:05.006Z
custom-time