Метод addTo

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

Импорт

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

Синтаксис

Temporal addTo(Temporal temporal)

Пример

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

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

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

String "2027-09-15"

Пример

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

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

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

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

Пример

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

val 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")

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

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

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

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