Функция minusMonths

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

Импорт

import java.time.YearMonth

Синтаксис

fun minusMonths(monthsToSubtract: Long): YearMonth

Пример

Вычтем 2 месяца из объекта YearMonth, представляющего "2025-03":

val yearMonth = YearMonth.of(2025, 3)
val result = yearMonth.minusMonths(2)
println(result)

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

String "2025-01"

Пример

Вычтем 12 месяцев (1 год) из объекта YearMonth:

val yearMonth = YearMonth.of(2025, 7)
val result = yearMonth.minusMonths(12)
println(result)

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

String "2024-07"

Пример

Вычтем большое количество месяцев с переходом через несколько лет:

val yearMonth = YearMonth.of(2025, 12)
val result = yearMonth.minusMonths(25)
println(result)

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

String "2023-11"

Пример

Проверим обработку февраля в високосном году:

val yearMonth = YearMonth.of(2024, 3)
val result = yearMonth.minusMonths(1)
println(result)
println("Days in month: " + result.lengthOfMonth())

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

String "2024-02"
String "Days in month: 29"

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

функцию plusMonths класса YearMonth,
которая добавляет месяцы к объекту YearMonth
функцию minusYears класса YearMonth,
которая вычитает годы из объекта YearMonth
функцию of класса YearMonth,
которая создает объект YearMonth из числовых компонентов
функцию minusMonths класса LocalDate,
которая вычитает месяцы из даты