Функция minusMonths

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

Импорт

import java.time.LocalDate

Синтаксис

fun minusMonths(monthsToSubtract: Long): LocalDate

Пример

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

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

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

String "2025-01-15"

Пример

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

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

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

String "2024-07-20"

Пример

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

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

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

String "2025-02-28"

Пример

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

val 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")

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

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

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

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