plus

Начиная с Kotlin: 2.3

operator fun plus(duration: Duration): Instant

Возвращает момент времени, полученный в результате прибавления указанной длительности к этому моменту.

Если длительность положительная, возвращённый момент времени наступает позже этого момента. Если длительность отрицательная, возвращённый момент времени наступает раньше этого момента.

Если результат выходит за допустимые границы Instant, возвращаемое значение ограничивается этими границами.

Важное замечание: значения Duration.Companion.days кратны 24 часам, однако в некоторых часовых поясах отдельные дни могут быть короче или длиннее из-за перевода часов. Для арифметических операций, учитывающих переходы между часовыми поясами, рассмотрите возможность использования kotlinx-datetime.

Примеры

import kotlin.test.*
import kotlin.time.*
import kotlin.time.Duration.Companion.hours
import kotlin.time.Duration.Companion.nanoseconds
import kotlin.time.Duration.Companion.seconds

fun main() { 
   //sampleStart 
   // Finding a moment that's later than the starting point by the given amount of real time
val instant = Instant.fromEpochSeconds(7 * 60 * 60, nanosecondAdjustment = 123_456_789)
val fiveHoursLater = instant + 5.hours
println(fiveHoursLater.epochSeconds == 12 * 60 * 60L) // true
println(fiveHoursLater.nanosecondsOfSecond == 123_456_789) // true 
   //sampleEnd
}