Temporal.Instant : méthode toJSON()

Syntaxe

toJSON()

Paramètres

Aucun.

Valeur de retour

Une chaîne de caractères représentant l'instant donné dans le format RFC 9557, avec autant de précision subsecondes que nécessaire pour représenter la durée avec exactitude, et avec le désignateur de fuseau horaire UTC Z.

Description

La méthode toJSON() est automatiquement appelée par JSON.stringify() lorsqu'un objet Temporal.Instant 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.Instant lors de la sérialisation JSON, qui peuvent ensuite être désérialisés en utilisant la fonction Temporal.Instant.from() comme reviver de JSON.parse().

Exemples

Utiliser la méthode toJSON()

const instant = Temporal.Instant.fromEpochMilliseconds(1627821296000);
const instantStr = instant.toJSON(); // '2021-08-01T12:34:56Z'
const i2 = Temporal.Instant.from(instantStr);

Sérialisation et analyse JSON

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

const instant = Temporal.Instant.fromEpochMilliseconds(1627821296000);
const jsonStr = JSON.stringify({ time: instant }); // '{"time":"2021-08-01T12:34:56Z"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "time") {
    return Temporal.Instant.from(value);
  }
  return value;
});

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Temporal.Instant
• La méthode statique Temporal.Instant.from()
• La méthode Temporal.Instant.prototype.toString()
• La méthode Temporal.Instant.prototype.toLocaleString()