Temporal.PlainYearMonth.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.PlainYearMonth Instanzen löst einen TypeError aus, der verhindert, dass Temporal.PlainYearMonth Instanzen implizit in primitive Werte umgewandelt werden, wenn sie in arithmetischen oder Vergleichsoperationen verwendet werden.
Syntax
valueOf()
Parameter
Keine.
Rückgabewert
Keiner.
Ausnahmen
TypeError-
Wird immer ausgelöst.
Beschreibung
Da sowohl die Umwandlung in primitive Werte als auch die Zahlenumwandlung valueOf() vor toString() aufrufen, würde bei Abwesenheit von valueOf() ein Ausdruck wie yearMonth1 > yearMonth2 diese implizit als Strings vergleichen, was unerwartete Ergebnisse haben könnte. Durch das Auslösen eines TypeError verhindern Temporal.PlainYearMonth Instanzen solche impliziten Umwandlungen. Sie müssen sie explizit in Strings umwandeln, indem Sie Temporal.PlainYearMonth.prototype.toString() verwenden, oder die statische Methode Temporal.PlainYearMonth.compare() benutzen, um sie zu vergleichen.
Beispiele
Arithmetische und Vergleichsoperationen auf Temporal.PlainYearMonth
Alle arithmetischen und Vergleichsoperationen auf Temporal.PlainYearMonth Instanzen sollten die dafür vorgesehenen Methoden verwenden oder diese explizit in primitive Werte umwandeln.
const ym1 = Temporal.PlainYearMonth.from("2021-01");
const ym2 = Temporal.PlainYearMonth.from("2021-07");
ym1 > ym2; // TypeError: can't convert PlainYearMonth to primitive type
Temporal.PlainYearMonth.compare(ym1, ym2); // -1
ym2 - ym1; // TypeError: can't convert PlainYearMonth to primitive type
ym2.since(ym1).toString(); // "P6M"
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plainyearmonth.prototype.valueof |