Функция plusMonths

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

Импорт

import java.time.YearMonth

Синтаксис

fun plusMonths(monthsToAdd: Long): YearMonth

Пример

Добавим 3 месяца к объекту "2025-05":

val yearMonth = YearMonth.of(2025, 5)
val result = yearMonth.plusMonths(3)
println(result)

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

String "2025-08"

Пример

Вычтем 5 месяцев из объекта "2025-03":

val yearMonth = YearMonth.of(2025, 3)
val result = yearMonth.plusMonths(-5)
println(result)

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

String "2024-10"

Пример

Добавим 12 месяцев (1 год) к объекту "2025-11":

val yearMonth = YearMonth.of(2025, 11)
val result = yearMonth.plusMonths(12)
println(result)

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

String "2026-11"

Пример

Добавим 0 месяцев к объекту "2025-07":

val yearMonth = YearMonth.of(2025, 7)
val result = yearMonth.plusMonths(0)
println(result)

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

String "2025-07"

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

функцию plusYears класса YearMonth,
которая добавляет годы к объекту YearMonth
функцию minusMonths класса YearMonth,
которая вычитает месяцы из объекта YearMonth
функцию of класса YearMonth,
которая создает объект YearMonth из года и месяца
функцию getYear класса YearMonth,
которая возвращает год из объекта YearMonth