Temporal.Instant.compare()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die Temporal.Instant.compare() statische Methode gibt eine Zahl (-1, 0 oder 1) zurück, die anzeigt, ob der erste Zeitpunkt vor, gleich oder nach dem zweiten Zeitpunkt kommt. Es ist äquivalent zum Vergleich der epochNanoseconds der beiden Zeitpunkte.
Syntax
Temporal.Instant.compare(instant1, instant2)
Parameter
instant1-
Ein String oder eine
Temporal.InstantInstanz, die den ersten Zeitpunkt darstellt, der verglichen werden soll. Er wird mithilfe des gleichen Algorithmus wieTemporal.Instant.from()in einTemporal.InstantObjekt konvertiert. instant2-
Der zweite Zeitpunkt, der verglichen werden soll, ebenfalls in ein
Temporal.InstantObjekt konvertiert, unter Verwendung des gleichen Algorithmus wieinstant1.
Rückgabewert
Gibt -1 zurück, wenn instant1 vor instant2 kommt, 0, wenn sie gleich sind, und 1, wenn instant1 nach instant2 kommt.
Beispiele
Verwendung von Temporal.Instant.compare()
const instant1 = Temporal.Instant.from("2021-08-01T12:34:56Z");
const instant2 = Temporal.Instant.from("2021-08-01T12:34:56Z");
console.log(Temporal.Instant.compare(instant1, instant2)); // 0
const instant3 = Temporal.Instant.from("2021-08-01T13:34:56Z");
console.log(Temporal.Instant.compare(instant1, instant3)); // -1
Sortieren eines Arrays von Zeitpunkten
Der Zweck dieser compare() Funktion ist es, als ein Vergleichsfunktion zu dienen, die an Array.prototype.sort() und verwandte Funktionen übergeben wird.
const instants = [
Temporal.Instant.from("2021-08-01T12:34:56Z"),
Temporal.Instant.from("2021-08-01T12:34:56+01:00"),
Temporal.Instant.from("2021-08-01T12:34:56-01:00"),
];
instants.sort(Temporal.Instant.compare);
console.log(instants.map((instant) => instant.toString()));
// [ '2021-08-01T11:34:56Z', '2021-08-01T12:34:56Z', '2021-08-01T13:34:56Z' ]
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.instant.compare |