Функция compareTo

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

Импорт

import java.time.Instant

Синтаксис

fun compareTo(other: Instant): Int

Пример

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

val 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")

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

String "Comparison result: -1"

Пример

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

val 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")

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

String "Comparison result: 0"

Пример

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

val 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")

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

String "Comparison result: 1"

Пример

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

val 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")
}

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

String "Current time is before future time"

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

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