Temporal.Instant.compare()

Статический метод Temporal.Instant.compare() возвращает число (-1, 0 или 1), указывающее, предшествует ли первый момент времени второму, совпадает ли с ним или следует за ним. Это эквивалентно сравнению epochNanoseconds двух моментов времени.

Синтаксис

Temporal.Instant.compare(instant1, instant2)

Параметры

instant1

Строка или экземпляр Temporal.Instant, представляющий первый момент времени для сравнения. Он преобразуется в объект Temporal.Instant с использованием того же алгоритма, что и Temporal.Instant.from().

instant2

Второй момент времени для сравнения, преобразуемый в объект Temporal.Instant с использованием того же алгоритма, что и instant1.

Возвращаемое значение

Возвращает -1, если instant1 предшествует instant2, 0, если они одинаковы, и 1, если instant1 следует за instant2.

Примеры

Использование 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

Сортировка массива моментов времени

Назначение этой функции compare() — служить компаратором, который можно передать в Array.prototype.sort() и связанные функции.

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' ]

Спецификации

Совместимость с браузерами

См. также

• Temporal.Instant
• Temporal.Instant.prototype.equals()