Temporal.PlainDateTime.prototype.toString()

语法

toString()
toString(options)

参数

options 可选

包含以下属性的对象

calendarName 可选

是否在返回值中显示日历注释 ([u-ca=calendar_id])。可能的值是：

"auto"（默认值）

如果日历不是 "iso8601"，则包含日历注释。

"always"

始终包含日历注释。

"never"

绝不应包含日历注释。这会使得返回的字符串无法恢复为相同的 Temporal.PlainDateTime 实例，尽管日期值仍然保持不变。

"critical"

始终包含日历注释，并添加一个关键标志：[!u-ca=calendar_id]。当将字符串发送到某些系统时很有用，但对 Temporal 本身没有用。

fractionalSecondDigits 可选

一个 0 到 9 之间的整数，或字符串 "auto"。默认值为 "auto"。如果为 "auto"，则从小数秒中删除尾随零。否则，秒组件的小数部分包含这么多位数，必要时用零填充或四舍五入。

roundingMode 可选

一个字符串，指定如何对超出 fractionalSecondDigits 的小数秒位数进行四舍五入。请参阅 Intl.NumberFormat()。默认为 "trunc"。

smallestUnit 可选

一个字符串，指定输出中包含的最小单位。可能的值是 "minute"、"second"、"millisecond"、"microsecond" 和 "nanosecond"，或它们的复数形式，它们（除了 "minute"）分别等同于 fractionalSecondDigits 值为 0、3、6、9。如果指定，则忽略 fractionalSecondDigits。

返回值

以RFC 9557 格式表示此日期时间的字符串。日历注释按规定包含在内。

异常

RangeError

如果任何选项无效，则抛出。

TypeError

如果 options 不是对象或 undefined，则抛出错误。

示例

使用 toString()

const dt = Temporal.PlainDateTime.from("2021-08-01T12:34:56");
console.log(dt.toString()); // '2021-08-01T12:34:56'

有关舍入时间的示例，请参阅 Temporal.PlainTime.prototype.toString()。有关显示日历的示例，请参阅 Temporal.PlainDate.prototype.toString()。

规范

浏览器兼容性

另见

• Temporal.PlainDateTime
• Temporal.PlainDateTime.from()
• Temporal.PlainDateTime.prototype.toJSON()
• Temporal.PlainDateTime.prototype.toLocaleString()