Функция ofEpochMilli

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

Импорт

import java.time.Instant

Синтаксис

fun ofEpochMilli(epochMilli: Long): Instant

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

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

Пример

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

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

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

String "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 из строки