Temporal.PlainTime.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.PlainTime-Instanzen wirft einen TypeError, was verhindert, dass Temporal.PlainTime-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 geworfen.
Beschreibung
Da sowohl die primitive Umwandlung als auch die Zahlenumwandlung valueOf() vor toString() aufrufen, würde ein Ausdruck wie time1 > time2, wenn valueOf() fehlt, sie implizit als Strings vergleichen, was zu unerwarteten Ergebnissen führen könnte. Durch das Werfen eines TypeError verhindern Temporal.PlainTime-Instanzen solche impliziten Umwandlungen. Sie müssen sie explizit in Strings umwandeln, indem Sie Temporal.PlainTime.prototype.toString() verwenden, oder die statische Methode Temporal.PlainTime.compare() nutzen, um sie zu vergleichen.
Beispiele
Arithmetische und Vergleichsoperationen mit Temporal.PlainTime
Alle arithmetischen und Vergleichsoperationen mit Temporal.PlainTime-Instanzen sollten die dafür vorgesehenen Methoden verwenden oder sie explizit in primitive Werte umwandeln.
const time1 = Temporal.PlainTime.from("00:00:00");
const time2 = Temporal.PlainTime.from("12:00:00");
time1 > time2; // TypeError: can't convert PlainTime to primitive type
Temporal.PlainTime.compare(time1, time2); // -1
time2 - time1; // TypeError: can't convert PlainTime to primitive type
time2.since(time1).toString(); // "PT12H"
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.valueof |