Функция plusMillis

Функция plusMillis класса Instant добавляет указанное количество миллисекунд к текущему моменту времени. В параметр мы передаем количество миллисекунд для добавления. Функция возвращает новый объект Instant, так как оригинальный объект является неизменяемым.

Импорт

import java.time.Instant

Синтаксис

fun plusMillis(millisToAdd: Long): Instant

Пример

Добавим 1500 миллисекунд к текущему моменту времени:

val instant = Instant.now()
val result = instant.plusMillis(1500)
println("Original: $instant")
println("After adding 1500ms: $result")

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

String "Original: 2025-09-10T14:30:45.123Z"
String "After adding 1500ms: 2025-09-10T14:30:46.623Z"

Пример

Добавим отрицательное количество миллисекунд (вычтем 500 миллисекунд):

val instant = Instant.parse("2025-07-15T10:30:00.000Z")
val result = instant.plusMillis(-500)
println("Original: $instant")
println("After subtracting 500ms: $result")

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

String "Original: 2025-07-15T10:30:00.000Z"
String "After subtracting 500ms: 2025-07-15T10:29:59.500Z"

Пример

Добавим несколько тысяч миллисекунд и преобразуем в миллисекунды с начала эпохи:

val instant = Instant.ofEpochMilli(1735669200000)
val result = instant.plusMillis(2500)

val originalMillis = instant.toEpochMilli()
val resultMillis = result.toEpochMilli()

println("Original epoch millis: $originalMillis")
println("Result epoch millis: $resultMillis")
println("Difference: ${resultMillis - originalMillis}")

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

String "Original epoch millis: 1735669200000"
String "Result epoch millis: 1735669202500"
String "Difference: 2500"

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

функцию plusSeconds класса Instant,
которая добавляет секунды к моменту времени
функцию plusNanos класса Instant,
которая добавляет наносекунды к моменту времени
функцию minusMillis класса Instant,
которая вычитает миллисекунды из момента времени
функцию ofEpochMilli класса Instant,
которая создает Instant из миллисекунд с начала эпохи