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 Temporal.PlainYearMonth Instanzen gibt ein neues Temporal.PlainDate Objekt zurück, das diese Jahr-Monat-Kombination und einen angegebenen Tag im selben Kalendersystem repräsentiert.

Syntax

toPlainDate(dayInfo)

Parameter

dayInfo Optional

Ein Objekt, das die Tageskomponente des resultierenden PlainDate repräsentiert 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 repräsentiert, 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()

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 # sec-temporal.plainyearmonth.prototype.toplaindate