Temporal.PlainMonthDay.prototype.toPlainDate()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die toPlainDate() Methode von Temporal.PlainMonthDay Instanzen gibt ein neues Temporal.PlainDate Objekt zurück, das diesen Monat-Tag und ein angegebenes Jahr im selben Kalendersystem darstellt.
Syntax
toPlainDate(yearInfo)
Parameter
yearInfo-
Ein Objekt, das die Jahreskomponente des resultierenden
PlainDatedarstellt und die folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):eraunderaYear-
Ein String und eine Ganzzahl, die den Eigenschaften
eraunderaYearentsprechen. Werden nur verwendet, wenn das Kalendersystem Epochen hat.eraunderaYearmüssen gleichzeitig bereitgestellt werden. Wenn sie nicht bereitgestellt werden, mussyearbereitgestellt werden. Wenn alleera,eraYearundyearbereitgestellt werden, müssen sie konsistent sein. year-
Entspricht der Eigenschaft
year.
Rückgabewert
Ein neues Temporal.PlainDate Objekt, das das durch diesen Monat-Tag und das Jahr in yearInfo angegebene Datum darstellt, interpretiert im Kalendersystem dieses Monat-Tages.
Ausnahmen
RangeError-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
TypeError-
Wird ausgelöst, wenn
yearInfokein 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 |