Функция ofEpochMilli

Функция ofEpochMilli класса Instant создает объект Instant из количества миллисекунд, прошедших с эпохи Unix (1 января 1970 года, 00:00:00 UTC). В единственный параметр мы передаем количество миллисекунд типа Long.

Импорт

kotlinimport java.time.Instant

Синтаксис

kotlinfun ofEpochMilli(epochMilli: Long): Instant

Пример

Создадим объект Instant из миллисекунд:

kotlinval milliseconds = 1735689600000L
val instant = Instant.ofEpochMilli(milliseconds)
println(instant)

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

kotlinString "2025-01-01T00:00:00Z"

Пример

Создадим Instant из текущего времени в миллисекундах:

kotlinval currentMillis = System.currentTimeMillis()
val instant = Instant.ofEpochMilli(currentMillis)
println("Current instant: $instant")

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

kotlinString "Current instant: 2025-01-01T12:30:45.123Z"

Пример

Преобразуем Instant обратно в миллисекунды с помощью функции toEpochMilli:

kotlinval originalMillis = 1735689600000L
val instant = Instant.ofEpochMilli(originalMillis)
val convertedMillis = instant.toEpochMilli()

println("Original: $originalMillis")
println("Converted: $convertedMillis")
println("Equal: ${originalMillis == convertedMillis}")

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

kotlinString "Original: 1735689600000"
String "Converted: 1735689600000"
String "Equal: true"

Пример

Создадим Instant для конкретной даты и извлечем компоненты времени:

kotlinval newYearMillis = 1735689600000L
val instant = Instant.ofEpochMilli(newYearMillis)

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

println("Epoch seconds: $seconds")
println("Nanoseconds: $nanos")
println("Full instant: $instant")

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

kotlinString "Epoch seconds: 1735689600"
String "Nanoseconds: 0"
String "Full instant: 2025-01-01T00:00:00Z"

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

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