Функция plusMonths

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

Импорт

import java.time.LocalDate

Синтаксис

fun plusMonths(monthsToAdd: Long): LocalDate

Пример

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

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

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

String "2025-04-15"

Пример

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

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

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

String "2025-01-31"

Пример

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

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

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

String "2026-02-28"

Пример

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

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

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

String "2025-02-28"

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

функцию plusYears класса LocalDate,
которая добавляет годы к дате
функцию plusWeeks класса LocalDate,
которая добавляет недели к дате
функцию plusDays класса LocalDate,
которая добавляет дни к дате
функцию minusMonths класса LocalDate,
которая вычитает месяцы из даты