Метод instant

Метод instant класса Clock возвращает текущий момент времени в виде объекта Instant. Момент времени представляет собой точку на временной шкале, независимую от часовых поясов и календарных систем.

Импорт

kotlinimport java.time.Clock

Синтаксис

kotlinfun instant(): Instant

Пример

Получим текущий момент времени с использованием системных часов по умолчанию:

kotlinval clock = Clock.systemDefaultZone()
val instant = clock.instant()
println(instant)

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

kotlinInstant "2025-09-10T12:34:56.789Z"

Пример

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

kotlinval clock = Clock.systemUTC()
val instant = clock.instant()
println(instant)

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

kotlinInstant "2025-09-10T12:34:56.789Z"

Пример

Сравним моменты времени, полученные из разных часов:

kotlinval defaultClock = Clock.systemDefaultZone()
val utcClock = Clock.systemUTC()

val instant1 = defaultClock.instant()
val instant2 = utcClock.instant()

val isEqual = instant1 == instant2
println("Moments are equal: $isEqual")

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

kotlinString "Moments are equal: true"

Пример

Используем фиксированные часы для тестирования:

kotlinimport java.time.Instant

val fixedInstant = Instant.parse("2025-12-31T23:59:59.999Z")
val fixedClock = Clock.fixed(fixedInstant, ZoneId.systemDefault())

val instant = fixedClock.instant()
println(instant)

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

kotlinInstant "2025-12-31T23:59:59.999Z"

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

  • метод systemDefaultZone класса Clock,
    который создает часы с системным часовым поясом по умолчанию
  • метод systemUTC класса Clock,
    который создает часы с UTC часовым поясом
  • метод fixed класса Clock,
    который создает фиксированные часы
  • класс Instant,
    который представляет момент времени на временной шкале