Функция plusSeconds

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

Импорт

kotlinimport java.time.Instant

Синтаксис

kotlinfun plusSeconds(secondsToAdd: Long): Instant

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

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

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