Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes