Функция minusMonths

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

Импорт

kotlinimport java.time.LocalDate

Синтаксис

kotlinfun minusMonths(monthsToSubtract: Long): LocalDate

Пример

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

kotlinval date = LocalDate.parse("2025-03-15")
val result = date.minusMonths(2)
println(result)

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

kotlinString "2025-01-15"

Пример

Вычтем 12 месяцев из даты "2025-07-20" (переход через год):

kotlinval date = LocalDate.parse("2025-07-20")
val result = date.minusMonths(12)
println(result)

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

kotlinString "2024-07-20"

Пример

Вычтем 1 месяц из даты "2025-03-31" (корректная обработка длины месяцев):

kotlinval date = LocalDate.parse("2025-03-31")
val result = date.minusMonths(1)
println(result)

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

kotlinString "2025-02-28"

Пример

Вычтем несколько месяцев и получим компоненты результирующей даты:

kotlinval date = LocalDate.parse("2025-12-10")
val result = date.minusMonths(5)

val year = result.year
val month = result.monthValue
val day = result.dayOfMonth

println("Year: $year, Month: $month, Day: $day")

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

kotlinString "Year: 2025, Month: 7, Day: 10"

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

  • функцию plusMonths класса LocalDate,
    которая добавляет месяцы к дате
  • функцию minusYears класса LocalDate,
    которая вычитает годы из даты
  • функцию minusDays класса LocalDate,
    которая вычитает дни из даты
  • класс Period,
    который представляет период времени в месяцах, годах и днях