Функция minusYears

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun minusYears(years: Long): LocalDateTime

Пример

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

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

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

String "2020-06-15T14:30"

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

String "2023-02-28T10:00"

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

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