Temporal.PlainTime.compare()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die statische Methode Temporal.PlainTime.compare() gibt eine Zahl (-1, 0 oder 1) zurück, die angibt, ob die erste Uhrzeit vor, gleich oder nach der zweiten Uhrzeit liegt. Dies entspricht dem Vergleichen der Felder Stunde, Minute, Sekunde, Millisekunde, Mikrosekunde und Nanosekunde nacheinander.
Syntax
Temporal.PlainTime.compare(time1, time2)
Parameter
time1-
Ein String, ein Objekt oder eine
Temporal.PlainTime-Instanz, die die erste zu vergleichende Uhrzeit repräsentiert. Es wird mit dem gleichen Algorithmus wieTemporal.PlainTime.from()in einTemporal.PlainTime-Objekt konvertiert. time2-
Die zweite zu vergleichende Uhrzeit, die mit dem gleichen Algorithmus wie
time1in einTemporal.PlainTime-Objekt konvertiert wird.
Rückgabewert
Gibt -1 zurück, wenn time1 vor time2 liegt, 0 wenn sie gleich sind, und 1 wenn time1 nach time2 liegt.
Beispiele
Verwendung von Temporal.PlainTime.compare()
const time1 = Temporal.PlainTime.from("12:34:56");
const time2 = Temporal.PlainTime.from("12:34:57");
console.log(Temporal.PlainTime.compare(time1, time2)); // -1
const time3 = Temporal.PlainTime.from("11:34:56");
console.log(Temporal.PlainTime.compare(time1, time3)); // 1
Sortieren eines Arrays von Uhrzeiten
Der Zweck dieser compare()-Funktion besteht darin, als Vergleichsfunktion für Array.prototype.sort() und verwandte Funktionen zu dienen.
const times = ["12:34:56", "11:34:56", "12:34:57"];
times.sort(Temporal.PlainTime.compare);
console.log(times);
// [ "11:34:56", "12:34:56", "12:34:57" ]
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaintime.compare |