Функция plusSeconds

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

Импорт

import java.time.Instant

Синтаксис

fun plusSeconds(secondsToAdd: Long): Instant

Пример

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

val currentInstant = Instant.now()
val futureInstant = currentInstant.plusSeconds(30)
println("Current: $currentInstant")
println("Future: $futureInstant")

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

String "Current: 2025-09-10T14:30:15.123Z"
String "Future: 2025-09-10T14:30:45.123Z"

Пример

Добавим 120 секунд (2 минуты) к конкретному моменту времени:

val instant = Instant.parse("2025-01-01T00:00:00Z")
val result = instant.plusSeconds(120)
println(result)

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

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

Пример

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

val instant = Instant.parse("2025-12-31T23:59:59Z")
val result = instant.plusSeconds(-45)
println(result)

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

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

Пример

Добавим большое количество секунд (эквивалентное 1 дню):

val instant = Instant.parse("2025-06-15T12:00:00Z")
val secondsInDay = 86400L
val result = instant.plusSeconds(secondsInDay)
println(result)

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

String "2025-06-16T12:00:00Z"

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

функцию plusMillis класса Instant,
которая добавляет миллисекунды к моменту времени
функцию plusNanos класса Instant,
которая добавляет наносекунды к моменту времени
функцию minusSeconds класса Instant,
которая вычитает секунды из момента времени
функцию now класса Instant,
которая возвращает текущий момент времени