Функция plusMonths

Функция plusMonths класса LocalDateTime добавляет указанное количество месяцев к текущей дате и времени. В параметр мы передаем количество месяцев для добавления. Функция возвращает новый объект LocalDateTime с измененным значением, исходный объект остается неизменным.

Импорт

import java.time.LocalDateTime

Синтаксис

fun plusMonths(monthsToAdd: Long): LocalDateTime

Пример

Добавим 3 месяца к дате и времени "2025-03-15T10:30:00":

val dateTime = LocalDateTime.parse("2025-03-15T10:30:00")
val result = dateTime.plusMonths(3)
println(result)

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

String "2025-06-15T10:30:00"

Пример

Добавим 12 месяцев (1 год) к дате и времени "2025-07-20T14:45:00":

val dateTime = LocalDateTime.parse("2025-07-20T14:45:00")
val result = dateTime.plusMonths(12)
println(result)

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

String "2026-07-20T14:45:00"

Пример

Добавим отрицательное количество месяцев (вычитание):

val dateTime = LocalDateTime.parse("2025-05-10T08:15:00")
val result = dateTime.plusMonths(-2)
println(result)

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

String "2025-03-10T08:15:00"

Пример

Обработка перехода через конец месяца:

val dateTime = LocalDateTime.parse("2025-01-31T12:00:00")
val result = dateTime.plusMonths(1)
println(result)

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

String "2025-02-28T12:00:00"

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

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