Temporal.Instant.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.Instant.compare() gibt eine Zahl (-1, 0 oder 1) zurück, die anzeigt, ob der erste Zeitpunkt vor, zur gleichen Zeit oder nach dem zweiten Zeitpunkt liegt. Sie entspricht dem Vergleich der epochNanoseconds der beiden Zeitpunkte.

Syntax

Temporal.Instant.compare(instant1, instant2)

Parameter

instant1: Ein String oder eine Temporal.Instant-Instanz, die den ersten zu vergleichenden Zeitpunkt darstellt. Er wird zu einem Temporal.Instant-Objekt konvertiert, indem derselbe Algorithmus wie bei Temporal.Instant.from() verwendet wird.
instant2: Der zweite zu vergleichende Zeitpunkt, konvertiert zu einem Temporal.Instant-Objekt, indem derselbe Algorithmus wie bei instant1 verwendet wird.

Rückgabewert

Gibt -1 zurück, wenn instant1 vor instant2 liegt, 0 wenn sie identisch sind, und 1 wenn instant1 nach instant2 liegt.

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 Vergleichsfunktion für Array.prototype.sort() und verwandte Funktionen zu dienen.

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