Temporal.PlainMonthDay.prototype.toPlainDate()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức toPlainDate() của các instance Temporal.PlainMonthDay trả về một đối tượng Temporal.PlainDate mới đại diện cho tháng-ngày này và một năm được cung cấp trong cùng hệ thống lịch.

Cú pháp

js
toPlainDate(yearInfo)

Tham số

yearInfo

Một đối tượng đại diện cho thành phần năm của PlainDate kết quả, chứa các thuộc tính sau (theo thứ tự chúng được lấy và xác thực):

eraeraYear

Một chuỗi và một số nguyên tương ứng với các thuộc tính eraeraYear. Chỉ được dùng nếu hệ thống lịch có kỷ nguyên. eraeraYear phải được cung cấp đồng thời. Nếu chúng không được cung cấp, thì year phải được cung cấp. Nếu tất cả era, eraYearyear đều được cung cấp, chúng phải nhất quán.

year

Tương ứng với thuộc tính year.

Giá trị trả về

Một đối tượng Temporal.PlainDate mới đại diện cho ngày được chỉ định bởi tháng-ngày này và năm trong yearInfo, được diễn giải trong hệ thống lịch của tháng-ngày này.

Ngoại lệ

RangeError

Được ném nếu bất kỳ tùy chọn nào không hợp lệ.

TypeError

Được ném nếu yearInfo không phải là đối tượng.

Ví dụ

Sử dụng 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]

Đặc tả kỹ thuật

Specification
Temporal
# sec-temporal.plainmonthday.prototype.toplaindate

Tính tương thích với trình duyệt

Xem thêm