Функция addTo

Функция addTo интерфейса TemporalUnit добавляет указанное количество единиц времени к объекту, реализующему интерфейс Temporal. В первый параметр мы передаем объект даты-времени, во второй параметр мы передаем количество единиц для добавления.

Импорт

kotlinimport java.time.temporal.TemporalUnit
import java.time.temporal.ChronoUnit

Синтаксис

kotlinfun addTo(temporal: Temporal, amount: Long): Temporal

Пример

Добавим 5 дней к дате "2025-03-15" с использованием ChronoUnit.DAYS:

kotlinimport java.time.LocalDate
import java.time.temporal.ChronoUnit

val date = LocalDate.parse("2025-03-15")
val newDate = ChronoUnit.DAYS.addTo(date, 5)
println(newDate)

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

kotlinString "2025-03-20"

Пример

Добавим 2 месяца к дате "2025-01-30" с использованием ChronoUnit.MONTHS:

kotlinimport java.time.LocalDate
import java.time.temporal.ChronoUnit

val date = LocalDate.parse("2025-01-30")
val newDate = ChronoUnit.MONTHS.addTo(date, 2)
println(newDate)

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

kotlinString "2025-03-30"

Пример

Добавим 3 часа ко времени "10:30:00" с использованием ChronoUnit.HOURS:

kotlinimport java.time.LocalTime
import java.time.temporal.ChronoUnit

val time = LocalTime.parse("10:30:00")
val newTime = ChronoUnit.HOURS.addTo(time, 3)
println(newTime)

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

kotlinString "13:30:00"

Пример

Добавим 1 год к объекту LocalDateTime с использованием ChronoUnit.YEARS:

kotlinimport java.time.LocalDateTime
import java.time.temporal.ChronoUnit

val dateTime = LocalDateTime.parse("2025-06-15T14:30:00")
val newDateTime = ChronoUnit.YEARS.addTo(dateTime, 1)
println(newDateTime)

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

kotlinString "2026-06-15T14:30:00"

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

  • функцию between интерфейса TemporalUnit,
    которая вычисляет разницу между двумя временными объектами
  • функцию addTo класса Period,
    которая добавляет период к временному объекту
  • функцию addTo класса Duration,
    которая добавляет длительность к временному объекту