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
underaYear
-
Ein String und eine Ganzzahl, die der
era
und dereraYear
Eigenschaft entsprechen. Sie werden nur verwendet, wenn das Kalendersystem Epochen hat.era
underaYear
müssen gleichzeitig angegeben werden. Wenn sie nicht angegeben werden, mussyear
angegeben werden. Wenn alleera
,eraYear
undyear
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 |