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 Temporal.PlainMonthDay Instanzen gibt ein neues Temporal.PlainDate Objekt zurück, das diesen Monat-Tag und ein angegebenes Jahr im gleichen Kalendersystem darstellt.

Syntax

js
toPlainDate(yearInfo)

Parameter

yearInfo

Ein Objekt, das die Jahreskomponente 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 den era und eraYear Eigenschaften entsprechen. Sie werden nur verwendet, wenn das Kalendersystem Epochen hat. era und eraYear müssen gleichzeitig angegeben werden. Wenn sie nicht angegeben sind, muss year angegeben werden. Wenn alle era, eraYear und year angegeben sind, müssen sie konsistent sein.

year

Entspricht der year Eigenschaft.

Rückgabewert

Ein neues Temporal.PlainDate Objekt, das das Datum darstellt, das durch diesen Monat-Tag und das Jahr in yearInfo angegeben ist, interpretiert im Kalendersystem dieses Monat-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()

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]

Spezifikationen

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toPlainDate
Experimental

Legend

Tip: you can click/tap on a cell for more information.

No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

Siehe auch