Date : mthode toJSON()

Exemple interactif

const event = new Date("August 19, 1975 23:15:30 UTC");

const jsonDate = event.toJSON();

console.log(jsonDate);
// Expected output: "1975-08-19T23:15:30.000Z"

console.log(new Date(jsonDate).toUTCString());
// Expected output: "Tue, 19 Aug 1975 23:15:30 GMT"

Syntaxe

toJSON()

Paramtres

Aucun.

Valeur de retour

Une chane de caractres reprsentant la date donne au format chane de date-heure selon le temps universel, ou null si la date est invalide. Pour les dates valides, la valeur de retour est identique celle de toISOString().

Description

La mthode toJSON() est automatiquement appele par JSON.stringify() lorsqu'un objet Date est converti en chane de caractres. Cette mthode est gnralement destine, par dfaut, srialiser utilement les objets Date lors de la srialisation JSON, qui peuvent ensuite tre dsrialiss l'aide du constructeur Date() comme reviver de JSON.parse().

La mthode tente d'abord de convertir sa valeur this en une valeur primitive en appelant successivement [Symbol.toPrimitive]() (avec l'indication "number"), valueOf(), puis toString(). Si le rsultat est un nombre non fini, null est retourn. (Cela correspond gnralement une date invalide, dont valueOf() retourne NaN.) Sinon, si la valeur primitive convertie n'est pas un nombre ou est un nombre fini, la valeur de retour de this.toISOString() est retourne.

Notez que la mthode ne vrifie pas si la valeur this est un objet Date valide. Cependant, appeler Date.prototype.toJSON() sur des objets qui ne sont pas des Date choue sauf si la reprsentation primitive numrique de l'objet est NaN, ou si l'objet possde aussi une mthode toISOString().

Exemple

Utiliser la mthode toJSON()

const jsonDate = new Date().toJSON(); // '1970-01-01T00:00:00.000Z'
const retourVersDate = new Date(jsonDate);

console.log(jsonDate); // 1970-01-01T00:00:00.000Z

Srialisation et dsrialisation

Lors de l'analyse d'un JSON contenant des chanes de caractres reprsentant des dates, vous pouvez utiliser le constructeur Date() pour les restaurer en objets date d'origine.

const donneeFichier = {
  author: "Maria",
  title: "Date.prototype.toJSON()",
  createdAt: new Date(2019, 3, 15),
  updatedAt: new Date(2020, 6, 26),
};
const reponse = JSON.stringify(donneeFichier);

// Imaginons une transmission par le rseau

const donnee = JSON.parse(reponse, (cle, valeur) => {
  if (cle === "createdAt" || cle === "updatedAt") {
    return new Date(valeur);
  }
  return valeur;
});

console.log(donnee);

Spcifications

Compatibilit des navigateurs

Voir aussi

• La mthode Date.prototype.toLocaleDateString()
• La mthode Date.prototype.toTimeString()
• La mthode Date.prototype.toUTCString()