Temporal.PlainTime.compare()

Статический метод Temporal.PlainTime.compare() возвращает число (-1, 0 или 1), указывающее, идет ли первое время раньше, совпадает ли оно или идет после второго времени. Он эквивалентен пошаговому сравнению полей часов, минут, секунд, миллисекунд, микросекунд и наносекунд.

Синтаксис

Temporal.PlainTime.compare(time1, time2)

Параметры

time1

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

time2

Второе сравниваемое время, преобразованное в объект Temporal.PlainTime с использованием того же алгоритма, что и time1.

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

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

Примеры

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

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

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

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

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

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

См. также

• Temporal.PlainTime
• Temporal.PlainTime.prototype.equals()