Temporal.PlainYearMonth.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.PlainYearMonth gibt ein neues Temporal.PlainDate Objekt zurück, das diesen Jahr-Monat und einen angegebenen Tag im selben Kalendersystem darstellt.

Syntax

js
toPlainDate(dayInfo)

Parameter

dayInfo Optional

Ein Objekt, das die Tageskomponente des resultierenden PlainDate darstellt und die folgende Eigenschaft enthält:

day

Entspricht der day Eigenschaft.

Rückgabewert

Ein neues Temporal.PlainDate Objekt, das das durch diesen Jahr-Monat und den Tag in dayInfo spezifizierte Datum darstellt, interpretiert im Kalendersystem dieses Jahr-Monats.

Ausnahmen

RangeError

Wird ausgelöst, wenn eine der Optionen ungültig ist.

TypeError

Wird ausgelöst, wenn dayInfo kein Objekt ist.

Beispiele

Verwendung von toPlainDate()

js
const ym = Temporal.PlainYearMonth.from("2021-07");
const date = ym.toPlainDate({ day: 1 });
console.log(date.toString()); // 2021-07-01

const ym2 = Temporal.PlainYearMonth.from("2021-07-01[u-ca=chinese]");
const date2 = ym2.toPlainDate({ day: 15 });
console.log(date2.toString()); // 2021-06-24[u-ca=chinese]

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch