Функция compareTo

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

Импорт

kotlinimport java.time.Instant

Синтаксис

kotlinfun compareTo(other: Instant): Int

Пример

Сравним два момента времени:

kotlinval instant1 = Instant.parse("2025-01-01T00:00:00Z")
val instant2 = Instant.parse("2025-01-02T00:00:00Z")

val result = instant1.compareTo(instant2)
println("Comparison result: $result")

Результат выполнения кода:

kotlinString "Comparison result: -1"

Пример

Сравним равные моменты времени:

kotlinval instant1 = Instant.parse("2025-06-15T12:30:00Z")
val instant2 = Instant.parse("2025-06-15T12:30:00Z")

val result = instant1.compareTo(instant2)
println("Comparison result: $result")

Результат выполнения кода:

kotlinString "Comparison result: 0"

Пример

Сравним более поздний момент с более ранним:

kotlinval instant1 = Instant.parse("2025-12-31T23:59:59Z")
val instant2 = Instant.parse("2025-01-01T00:00:00Z")

val result = instant1.compareTo(instant2)
println("Comparison result: $result")

Результат выполнения кода:

kotlinString "Comparison result: 1"

Пример

Используем результат сравнения в условном выражении:

kotlinval now = Instant.now()
val future = Instant.parse("2025-12-31T23:59:59Z")

val comparison = now.compareTo(future)

if (comparison < 0) {
  println("Current time is before future time")
} else if (comparison > 0) {
  println("Current time is after future time")
} else {
  println("Times are equal")
}

Результат выполнения кода:

kotlinString "Current time is before future time"

Смотрите также

  • функцию isBefore класса Instant,
    которая проверяет, является ли момент времени более ранним
  • функцию isAfter класса Instant,
    которая проверяет, является ли момент времени более поздним
  • функцию now класса Instant,
    которая возвращает текущий момент времени
  • функцию parse класса Instant,
    которая преобразует строку в объект Instant