Функция parse

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

Импорт

import java.time.Instant

Синтаксис

fun parse(text: CharSequence): Instant

Пример

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

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

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

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

Пример

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

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

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

String "Seconds: 1757845845, Nanos: 789000000"

Пример

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

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

println("Milliseconds: $millis")

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

String "Milliseconds: 1735689600000"

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

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