Метод addTo

Метод addTo интерфейса TemporalAmount добавляет данный временной промежуток к указанному временному объекту. В первый параметр мы передаем временной объект для модификации, метод возвращает новый временной объект с добавленным промежутком времени.

Импорт

kotlinimport java.time.temporal.TemporalAmount
import java.time.LocalDate
import java.time.Period

Синтаксис

kotlinTemporal addTo(Temporal temporal)

Пример

Добавим период в 2 года и 3 месяца к дате "2025-06-15":

kotlinval date = LocalDate.of(2025, 6, 15)
val period = Period.of(2, 3, 0)
val newDate = period.addTo(date)
println(newDate)

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

kotlinString "2027-09-15"

Пример

Добавим период в 10 дней к текущей дате:

kotlinval currentDate = LocalDate.now()
val period = Period.ofDays(10)
val futureDate = period.addTo(currentDate)
println("Current date: $currentDate")
println("Future date: $futureDate")

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

kotlinString "Current date: 2025-09-10"
String "Future date: 2025-09-20"

Пример

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

kotlinval date = LocalDate.of(2025, 12, 25)
val period = Period.of(0, 6, 15)
val newDate = period.addTo(date)

val year = newDate.year
val month = newDate.monthValue
val day = newDate.dayOfMonth

println("Year: $year, Month: $month, Day: $day")

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

kotlinString "Year: 2026, Month: 7, Day: 10"

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

  • метод plus класса Period,
    который складывает периоды
  • метод subtractFrom интерфейса TemporalAmount,
    который вычитает период из временного объекта
  • метод plusDays класса LocalDate,
    который добавляет дни к дате