Функция minusYears

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

Импорт

kotlinimport java.time.LocalDateTime

Синтаксис

kotlinfun minusYears(years: Long): LocalDateTime

Пример

Вычтем 5 лет из даты и времени "2025-06-15T14:30:00":

kotlinval dateTime = LocalDateTime.parse("2025-06-15T14:30:00")
val result = dateTime.minusYears(5)
println(result)

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

kotlinString "2020-06-15T14:30"

Пример

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

kotlinval currentDateTime = LocalDateTime.now()
val result = currentDateTime.minusYears(10)
println("Current: $currentDateTime")
println("Minus 10 years: $result")

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

kotlinString "Current: 2025-09-10T12:30:45, Minus 10 years: 2015-09-10T12:30:45"

Пример

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

kotlinval dateTime = LocalDateTime.of(2025, 12, 31, 23, 59)
val result = dateTime.minusYears(3)

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

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

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

kotlinString "Year: 2022, Month: 12, Day: 31, Hour: 23"

Пример

Вычтем 1 год из даты с високосным днем:

kotlinval leapDate = LocalDateTime.of(2024, 2, 29, 10, 0)
val result = leapDate.minusYears(1)
println(result)

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

kotlinString "2023-02-28T10:00"

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

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