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 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 Nummerkonvertierung valueOf() vor toString() aufrufen, würde ein Ausdruck wie yearMonth1 > yearMonth2 diese, falls valueOf() abwesend ist, implizit als Zeichenfolgen vergleichen, was unerwartete Ergebnisse liefern kann. Indem ein TypeError ausgelöst wird, verhindern Temporal.PlainYearMonth Instanzen solche impliziten Konvertierungen. Sie müssen sie explizit in Zeichenfolgen umwandeln, indem Sie Temporal.PlainYearMonth.prototype.toString() verwenden, oder die statische Methode Temporal.PlainYearMonth.compare() verwenden, um sie zu vergleichen.
Beispiele
Arithmetische und Vergleichsoperationen auf Temporal.PlainYearMonth
Alle arithmetischen und Vergleichsoperationen auf Temporal.PlainYearMonth Instanzen sollten die dedizierten Methoden nutzen oder sie explizit 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 proposal # sec-temporal.plainyearmonth.prototype.valueof |
Browser-Kompatibilität
BCD tables only load in the browser