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

Exemples

Utiliser la méthode toJSON()

js
const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ymStr = ym.toJSON(); // '2021-08'
const ym2 = Temporal.PlainYearMonth.from(ymStr);

Sérialisation et analyse JSON

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

js
const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ymStr = JSON.stringify({ event: ym }); // '{"event":"2021-08"}'
const obj = JSON.parse(ymStr, (key, value) => {
  if (key === "event") {
    return Temporal.PlainYearMonth.from(value);
  }
  return value;
});

Spécifications

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

Compatibilité des navigateurs

Voir aussi