Функция plusMonths

Функция plusMonths класса LocalDate добавляет указанное количество месяцев к текущей дате и возвращает новый объект LocalDate. В параметр мы передаем количество месяцев для добавления (может быть отрицательным для вычитания). Функция корректно обрабатывает переходы через конец месяца и високосные годы.

Импорт

kotlinimport java.time.LocalDate

Синтаксис

kotlinfun plusMonths(monthsToAdd: Long): LocalDate

Пример

Добавим 3 месяца к дате "2025-01-15":

kotlinval date = LocalDate.parse("2025-01-15")
val newDate = date.plusMonths(3)
println(newDate)

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

kotlinString "2025-04-15"

Пример

Вычтем 2 месяца из даты "2025-03-31":

kotlinval date = LocalDate.parse("2025-03-31")
val newDate = date.plusMonths(-2)
println(newDate)

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

kotlinString "2025-01-31"

Пример

Добавим 12 месяцев к дате "2025-02-28" (проверка високосного года):

kotlinval date = LocalDate.parse("2025-02-28")
val newDate = date.plusMonths(12)
println(newDate)

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

kotlinString "2026-02-28"

Пример

Добавим 1 месяц к последнему дню месяца и посмотрим результат:

kotlinval date = LocalDate.parse("2025-01-31")
val newDate = date.plusMonths(1)
println(newDate)

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

kotlinString "2025-02-28"

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