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.PlainDateTime : 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.PlainDateTime retourne une chaîne de caractères représentant cette date et heure 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 et l'heure données 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.PlainDateTime est converti en chaîne de caractères JSON. Cette méthode est généralement destinée à, par défaut, sérialiser de manière utile les objets Temporal.PlainDateTime lors de la sérialisation JSON, qui peuvent ensuite être désérialisés en utilisant la fonction Temporal.PlainDateTime.from() comme réactivateur de JSON.parse().

Exemples

Utiliser la méthode toJSON()

js
const dt = Temporal.PlainDateTime.from({ year: 2021, month: 8, day: 1 });
const dtStr = dt.toJSON(); // '2021-08-01T00:00:00'
const dt2 = Temporal.PlainDateTime.from(dtStr);

Sérialisation et analyse JSON

Cet exemple montre comment Temporal.PlainDateTime peut être sérialisé en JSON sans effort supplémentaire, et comment le réanalyser.

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

Spécifications

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

Compatibilité des navigateurs

Voir aussi