Temporal.PlainDate.prototype.toString()
toString() 方法是 Temporal.PlainDate 实例上的一个方法，它返回一个以 RFC 9557 格式表示此日期的字符串。
语法
js
toString()
toString(options)
参数
options可选-
包含以下属性的对象
calendarName可选-
是否在返回值中显示日历注释 (
[u-ca=calendar_id])。可能的值是："auto"（默认值）-
如果日历不是
"iso8601"，则包含日历注释。 "always"-
始终包含日历注释。
"never"-
切勿包含日历注解。这使得返回的字符串无法恢复到相同的
Temporal.PlainDate实例，尽管日期值本身保持不变。 "critical"-
始终包含日历注释，并添加一个关键标志：
[!u-ca=calendar_id]。当将字符串发送到某些系统时很有用，但对 Temporal 本身没有用。
返回值
一个以 RFC 9557 格式表示此日期的字符串。日历注解将按指定包含在内。
异常
RangeError-
如果任何选项无效，则抛出。
TypeError-
如果
options不是对象或undefined，则抛出错误。
示例
使用 toString()
js
const date = Temporal.PlainDate.from("2021-08-01");
console.log(date.toString()); // '2021-08-01'
使用选项
js
const isoDate = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const date = Temporal.PlainDate.from({
year: 2021,
month: 8,
day: 1,
calendar: "islamic-umalqura",
});
console.log(isoDate.toString({ calendarName: "auto" })); // '2021-08-01'
console.log(date.toString({ calendarName: "auto" })); // '2582-12-17[u-ca=islamic-umalqura]'
console.log(isoDate.toString({ calendarName: "always" })); // '2021-08-01[u-ca=iso8601]'
console.log(date.toString({ calendarName: "always" })); // '2582-12-17[u-ca=islamic-umalqura]'
console.log(date.toString({ calendarName: "never" })); // '2582-12-17'
console.log(isoDate.toString({ calendarName: "critical" })); // '2021-08-01[!u-ca=iso8601]'
console.log(date.toString({ calendarName: "critical" })); // '2582-12-17[!u-ca=islamic-umalqura]'
规范
| 规范 |
|---|
| Temporal # sec-temporal.plaindate.prototype.tostring |
浏览器兼容性
加载中…