Temporal.PlainMonthDay.prototype.toPlainDate()

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

toPlainDate() 方法是 Temporal.PlainMonthDay 例項的一個方法，它返回一個新的 Temporal.PlainDate 物件，該物件表示此月份-日期以及提供的年份，使用相同的日曆系統。

語法

toPlainDate(yearInfo)

引數

yearInfo

一個表示結果 PlainDate 的年份元件的物件，包含以下屬性（按照檢索和驗證的順序）：

era 和 eraYear: 一個字串和一個整數，分別對應 era 和 eraYear 屬性。僅當日歷系統包含紀元時使用。era 和 eraYear 必須同時提供。如果未提供，則必須提供 year。如果同時提供了 era、eraYear 和 year，它們必須一致。
年: 對應於 year 屬性。

返回值

一個新的 Temporal.PlainDate 物件，表示此月份-日期和 yearInfo 中的年份指定的日期，並根據此月份-日期的日曆系統進行解釋。

異常

RangeError: 如果任何選項無效，則丟擲。
TypeError: 如果 yearInfo 不是一個物件，則丟擲該錯誤。

示例

使用 toPlainDate()

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

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025 年 7 月 10 日，由 MDN 貢獻者進行修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題