Функция minusMonths

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun minusMonths(months: Long): LocalDateTime

Пример

Вычтем 2 месяца из даты и времени "2025-03-15T10:30:00":

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

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

String "2025-01-15T10:30"

Пример

Вычтем 12 месяцев (1 год) из даты и времени:

val dateTime = LocalDateTime.of(2025, 7, 20, 14, 45)
val result = dateTime.minusMonths(12)
println(result)

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

String "2024-07-20T14:45"

Пример

Вычтем 1 месяц из даты 31 января 2025 года:

val dateTime = LocalDateTime.of(2025, 1, 31, 0, 0)
val result = dateTime.minusMonths(1)
println(result)

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

String "2024-12-31T00:00"

Пример

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

val original = LocalDateTime.parse("2025-05-31T12:00:00")
val modified = original.minusMonths(3)

val year = modified.year
val month = modified.monthValue
val day = modified.dayOfMonth
val hour = modified.hour

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

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

String "Year: 2025, Month: 2, Day: 28, Hour: 12"

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

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