Temporal.PlainYearMonth.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.PlainYearMonth Instanzen löst einen TypeError aus, der verhindert, dass Temporal.PlainYearMonth Instanzen implizit in Primitive 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ürden in Abwesenheit von valueOf() Ausdrücke wie yearMonth1 > yearMonth2 sie implizit als Zeichenketten vergleichen, was unerwartete Ergebnisse liefern kann. Durch das Auslösen eines TypeError verhindern Temporal.PlainYearMonth Instanzen solche impliziten Konvertierungen. Sie müssen sie ausdrücklich mithilfe von Temporal.PlainYearMonth.prototype.toString() in Zeichenketten umwandeln oder die Temporal.PlainYearMonth.compare()-statische Methode verwenden, 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 ausdrücklich in Primitive konvertieren.
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 |