Temporal.PlainMonthDay.prototype.toPlainDate()

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die toPlainDate() Methode von Instanzen des Temporal.PlainMonthDay gibt ein neues Temporal.PlainDate Objekt zurück, das diesen Monats-Tag und ein angegebenes Jahr im selben Kalendersystem darstellt.

Syntax

toPlainDate(yearInfo)

Parameter

yearInfo

Ein Objekt, das die Jahr-Komponente des resultierenden PlainDate darstellt und die folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):

era und eraYear: Ein String und eine Ganzzahl, die der era und der eraYear Eigenschaft entsprechen. Sie werden nur verwendet, wenn das Kalendersystem Epochen hat. era und eraYear müssen gleichzeitig angegeben werden. Wenn sie nicht angegeben werden, muss year angegeben werden. Wenn alle era, eraYear und year angegeben werden, müssen sie konsistent sein.
year: Entspricht der year Eigenschaft.

Rückgabewert

Ein neues Temporal.PlainDate Objekt, das das Datum darstellt, das durch diesen Monats-Tag und das Jahr in yearInfo beschrieben wird, interpretiert im Kalendersystem dieses Monats-Tages.

Ausnahmen

RangeError: Wird ausgelöst, wenn eine der Optionen ungültig ist.
TypeError: Wird ausgelöst, wenn yearInfo kein Objekt ist.

Beispiele

Verwendung von 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]

Spezifikationen

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