Temporal.PlainMonthDay.prototype.valueOf()
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 valueOf()-Methode von Temporal.PlainMonthDay-Instanzen wirft einen TypeError, was verhindert, dass Temporal.PlainMonthDay-Instanzen implizit in primitive Typen umgewandelt 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 ein Ausdruck wie monthDay1 > monthDay2 sie implizit als Strings vergleichen, was unerwartete Ergebnisse liefern könnte, wenn valueOf() fehlt. Durch das Auslösen eines TypeError verhindern Temporal.PlainMonthDay-Instanzen solche impliziten Konvertierungen. Sie müssen sie explizit in Strings 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 Typen 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 |