Функция parse

Функция parse класса Instant преобразует строку в формате ISO-8601 в объект Instant, который представляет момент времени на временной шкале UTC. В параметр передается строка для преобразования, которая должна соответствовать формату год-месяц-деньTчасы:минуты:секунды.доли_секундZ.

Импорт

kotlinimport java.time.Instant

Синтаксис

kotlinfun parse(text: CharSequence): Instant

Пример

Преобразуем строку "2025-12-31T23:59:59.123Z" в объект Instant:

kotlinval instantStr = "2025-12-31T23:59:59.123Z"
val instant = Instant.parse(instantStr)
println(instant)

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

kotlinString "2025-12-31T23:59:59.123Z"

Пример

Получим компоненты времени после парсинга:

kotlinval instantStr = "2025-07-15T12:30:45.789Z"
val instant = Instant.parse(instantStr)

val seconds = instant.epochSecond
val nanos = instant.nano

println("Seconds: $seconds, Nanos: $nanos")

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

kotlinString "Seconds: 1757845845, Nanos: 789000000"

Пример

Преобразуем Instant в миллисекунды с начала эпохи Unix:

kotlinval instantStr = "2025-01-01T00:00:00Z"
val instant = Instant.parse(instantStr)
val millis = instant.toEpochMilli()

println("Milliseconds: $millis")

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

kotlinString "Milliseconds: 1735689600000"

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

  • функцию now класса Instant,
    которая возвращает текущий момент времени
  • функцию ofEpochSecond класса Instant,
    которая создает Instant из секунд и наносекунд
  • функцию toEpochMilli класса Instant,
    которая преобразует Instant в миллисекунды
  • класс ZonedDateTime,
    который представляет дату и время с часовым поясом