Функция minusDays

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun minusDays(days: Long): LocalDateTime

Пример

Вычтем 5 дней из даты и времени "2025-07-15T10:30:00":

val dateTime = LocalDateTime.parse("2025-07-15T10:30:00")
val result = dateTime.minusDays(5)
println(result)

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

String "2025-07-10T10:30"

Пример

Вычтем 30 дней из текущей даты и времени:

val currentDateTime = LocalDateTime.now()
val result = currentDateTime.minusDays(30)
println("Current: $currentDateTime")
println("Minus 30 days: $result")

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

String "Current: 2025-09-10T14:25:30.123, Minus 30 days: 2025-08-11T14:25:30.123"

Пример

Вычтем 1 день из даты и времени и получим компоненты результата:

val dateTime = LocalDateTime.of(2025, 12, 31, 23, 45)
val result = dateTime.minusDays(1)

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

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

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

String "Year: 2025, Month: 12, Day: 30, Time: 23:45"

Пример

Вычтем большое количество дней (365 дней) из даты и времени:

val dateTime = LocalDateTime.parse("2025-06-15T12:00:00")
val result = dateTime.minusDays(365)
println(result)

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

String "2024-06-15T12:00"

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

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