Temporal.PlainMonthDay.prototype.toPlainDate()

可用性有限

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

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

toPlainDate() 方法是 Temporal.PlainMonthDay 实例的一个方法,它返回一个新的 Temporal.PlainDate 对象,该对象表示此月份-日期以及提供的年份,使用相同的日历系统。

语法

js
toPlainDate(yearInfo)

参数

yearInfo

一个表示结果 PlainDate 的年份组件的对象,包含以下属性(按照检索和验证的顺序):

eraeraYear

一个字符串和一个整数,分别对应 eraeraYear 属性。仅当日历系统包含纪元时使用。eraeraYear 必须同时提供。如果未提供,则必须提供 year。如果同时提供了 eraeraYearyear,它们必须一致。

对应于 year 属性。

返回值

一个新的 Temporal.PlainDate 对象,表示此月份-日期和 yearInfo 中的年份指定的日期,并根据此月份-日期的日历系统进行解释。

异常

RangeError

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

TypeError

如果 yearInfo 不是一个对象,则抛出该错误。

示例

使用 toPlainDate()

js
const md = Temporal.PlainMonthDay.from("07-01");
const date = md.toPlainDate({ year: 2021 });
console.log(date.toString()); // 2021-07-01

const md2 = Temporal.PlainMonthDay.from("2021-07-01[u-ca=japanese]");
const date2 = md2.toPlainDate({ era: "reiwa", eraYear: 1 });
console.log(date2.toString()); // 2019-07-01[u-ca=japanese]

规范

规范
Temporal
# sec-temporal.plainmonthday.prototype.toplaindate

浏览器兼容性

另见