Temporal.PlainMonthDay.prototype.valueOf()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die valueOf()-Methode von Temporal.PlainMonthDay-Instanzen wirft einen TypeError, was verhindert, dass Temporal.PlainMonthDay-Instanzen implizit in Primitive konvertiert werden, wenn sie in arithmetischen oder Vergleichsoperationen verwendet werden.
Syntax
valueOf()
Parameter
Keine.
Rückgabewert
Keine.
Ausnahmen
TypeError-
Wird immer ausgelöst.
Beschreibung
Da sowohl die primitive Konvertierung als auch die Zahlenkonvertierung valueOf() vor toString() aufrufen, würde bei Fehlen von valueOf() ein Ausdruck wie monthDay1 > monthDay2 sie implizit als Zeichenfolgen vergleichen, was unerwartete Ergebnisse haben kann. Durch das Auslösen eines TypeError verhindern Temporal.PlainMonthDay-Instanzen solche impliziten Konvertierungen. Sie müssen sie explizit in Zeichenfolgen umwandeln, indem Sie Temporal.PlainMonthDay.prototype.toString() verwenden.
Beispiele
Arithmetische und Vergleichsoperationen auf Temporal.PlainMonthDay
Alle arithmetischen und Vergleichsoperationen auf Temporal.PlainMonthDay-Instanzen sollten die dedizierten Methoden verwenden oder sie explizit in Primitive umwandeln.
const md1 = Temporal.PlainMonthDay.from("01-01");
const md2 = Temporal.PlainMonthDay.from("07-01");
md1 > md2; // TypeError: can't convert PlainMonthDay to primitive type
Temporal.PlainDate.compare(
md1.toPlainDate({ year: 2021 }),
md2.toPlainDate({ year: 2021 }),
); // -1
md2 - md1; // TypeError: can't convert PlainMonthDay to primitive type
md2
.toPlainDate({ year: 2021 })
.since(md1.toPlainDate({ year: 2021 }))
.toString(); // "P181D"
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plainmonthday.prototype.valueof |