Temporal.PlainDate.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.PlainDate Instanzen wirft einen TypeError, welcher verhindert, dass Temporal.PlainDate Instanzen implizit zu primitiven Werten 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 Konversion als auch die Zahlenkonversion valueOf() vor toString() aufrufen, würde ein Ausdruck wie date1 > date2, falls valueOf() nicht vorhanden ist, sie implizit als Strings vergleichen, was unerwartete Ergebnisse haben könnte. Durch das Werfen eines TypeError verhindern Temporal.PlainDate Instanzen solche impliziten Konversionen. Sie müssen sie explizit mit Temporal.PlainDate.prototype.toString() in Strings umwandeln oder die statische Methode Temporal.PlainDate.compare() verwenden, um sie zu vergleichen.
Beispiele
Arithmetische und Vergleichsoperationen auf Temporal.PlainDate
Alle arithmetischen und Vergleichsoperationen auf Temporal.PlainDate-Instanzen sollten die dedizierten Methoden verwenden oder die Instanzen explizit in primitive Werte umwandeln.
const date1 = Temporal.PlainDate.from("2022-01-01");
const date2 = Temporal.PlainDate.from("2022-07-01");
date1 > date2; // TypeError: can't convert PlainDate to primitive type
Temporal.PlainDate.compare(date1, date2); // -1
date2 - date1; // TypeError: can't convert PlainDate to primitive type
date2.since(date1).toString(); // "P181D"
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindate.prototype.valueof |