Temporal.PlainTime.prototype.toJSON()

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

toJSON() 方法 Temporal.PlainTime 实例会返回一个字符串,该字符串以与调用 toString() 相同的 RFC 9557 格式表示此时间。它旨在被 JSON.stringify() 隐式调用。

语法

js
toJSON()

参数

无。

返回值

一个表示给定时间的字符串,采用 RFC 9557 格式

描述

Temporal.PlainTime 对象被序列化为字符串时,toJSON() 方法会被 JSON.stringify() 自动调用。此方法通常旨在默认情况下有效序列化 Temporal.PlainTime 对象,以便在 JSON 序列化过程中进行反序列化,然后可以使用 Temporal.PlainTime.from() 函数作为 JSON.parse() 的 reviver 来反序列化。

示例

使用 toJSON()

js
const time = Temporal.PlainTime.from({ hour: 12, minute: 34, second: 56 });
const timeStr = time.toJSON(); // '12:34:56'
const t2 = Temporal.PlainTime.from(timeStr);

JSON 序列化和解析

本示例展示了如何在无需额外努力的情况下将 Temporal.PlainTime 序列化为 JSON,以及如何将其解析回。

js
const time = Temporal.PlainTime.from({ hour: 12, minute: 34, second: 56 });
const jsonStr = JSON.stringify({ time }); // '{"time":"12:34:56"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "time") {
    return Temporal.PlainTime.from(value);
  }
  return value;
});

规范

规范
Temporal
# sec-temporal.plaintime.prototype.tojson

浏览器兼容性

另见