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