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.PlainMonthDay : 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.PlainMonthDay retourne une chaîne de caractères représentant ce mois-jour 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 le mois et le jour donnés au format RFC 9557, avec l'année et l'annotation du calendrier incluses si ce n'est pas "iso8601".

Description

La méthode toJSON() est appelée automatiquement par JSON.stringify() lorsqu'un objet Temporal.PlainMonthDay est sérialisé. Elle permet de sérialiser utilement les objets Temporal.PlainMonthDay dans du JSON, qui peut ensuite être désérialisé en utilisant la fonction Temporal.PlainMonthDay.from() comme revitaliseur dans JSON.parse().

Exemples

Utiliser la méthode toJSON()

js
const md = Temporal.PlainMonthDay.from({ month: 8, day: 1 });
const mdStr = md.toJSON(); // '08-01'
const md2 = Temporal.PlainMonthDay.from(mdStr);

Sérialisation et analyse de JSON

Cet exemple montre comment Temporal.PlainMonthDay peut être sérialisé dans du JSON sans effort supplémentaire, et comment l'analyser ensuite.

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

Spécifications

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

Compatibilité des navigateurs

Voir aussi