Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Temporal.PlainDate : méthode toJSON()

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La méthode toJSON() des instances de Temporal.PlainDate retourne une chaîne de caractères représentant cette date dans le même format RFC 9557 que l'appel de toString(). Elle est destinée à être appelée implicitement par JSON.stringify().

Syntaxe

js
toJSON()

Paramètres

Aucun.

Valeur de retour

Une chaîne de caractères représentant la date donnée dans le format RFC 9557, avec l'annotation du calendrier incluse si ce n'est pas "iso8601".

Description

La méthode toJSON() est automatiquement appelée par JSON.stringify() lorsqu'un objet Temporal.PlainDate est converti en chaîne de caractères. Cette méthode est généralement destinée à, par défaut, sérialiser de manière utile les objets Temporal.PlainDate lors de la sérialisation JSON, qui peuvent ensuite être désérialisés en utilisant la fonction Temporal.PlainDate.from() comme réactivateur de JSON.parse().

Exemples

Utiliser la méthode toJSON()

js
const date = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const dateStr = date.toJSON(); // '2021-08-01'
const d2 = Temporal.PlainDate.from(dateStr);

Sérialisation et analyse JSON

Cet exemple montre comment Temporal.PlainDate peut être sérialisé en JSON sans effort supplémentaire, et comment l'analyser à nouveau.

js
const date = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const jsonStr = JSON.stringify({ date }); // '{"date":"2021-08-01"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "date") {
    return Temporal.PlainDate.from(value);
  }
  return value;
});

Spécifications

Spécification
Temporal
# sec-temporal.plaindate.prototype.tojson

Compatibilité des navigateurs

Voir aussi