Temporal.PlainTime.compare()

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 statische Methode Temporal.PlainTime.compare() gibt eine Zahl (-1, 0 oder 1) zurück, die angibt, ob die erste Zeit vor, gleich oder nach der zweiten Zeit liegt. Dies entspricht dem Vergleich der Felder Stunde, Minute, Sekunde, Millisekunde, Mikrosekunde und Nanosekunde nacheinander.

Syntax

js
Temporal.PlainTime.compare(time1, time2)

Parameter

time1

Ein String, ein Objekt oder eine Temporal.PlainTime-Instanz, die die erste zu vergleichende Zeit darstellt. Sie wird in ein Temporal.PlainTime-Objekt umgewandelt, indem derselbe Algorithmus wie bei Temporal.PlainTime.from() verwendet wird.

time2

Die zweite zu vergleichende Zeit, umgewandelt in ein Temporal.PlainTime-Objekt unter Verwendung desselben Algorithmus wie time1.

Rückgabewert

Gibt -1 zurück, wenn time1 vor time2 liegt, 0, wenn sie gleich sind, und 1, wenn time2 nach time1 liegt.

Beispiele

Verwendung von Temporal.PlainTime.compare()

js
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 Zeiten

Der Zweck dieser compare()-Funktion besteht darin, als Vergleichsfunktion zu fungieren, die an Array.prototype.sort() und verwandte Funktionen übergeben wird.

js
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 proposal
# sec-temporal.plaintime.compare

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
compare
Experimental

Legend

Tip: you can click/tap on a cell for more information.

In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

Siehe auch