Функция minusYears

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

Импорт

kotlinimport java.time.LocalDate

Синтаксис

kotlinfun minusYears(yearsToSubtract: Long): LocalDate

Пример

Вычтем 5 лет из даты "2025-03-15":

kotlinval originalDate = LocalDate.parse("2025-03-15")
val newDate = originalDate.minusYears(5)
println(newDate)

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

kotlinString "2020-03-15"

Пример

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

kotlinval currentDate = LocalDate.now()
val pastDate = currentDate.minusYears(10)
println("Current date: $currentDate")
println("Date 10 years ago: $pastDate")

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

kotlinString "Current date: 2025-09-10"
String "Date 10 years ago: 2015-09-10"

Пример

Вычтем 1 год из даты "2024-02-29" (високосный год):

kotlinval leapYearDate = LocalDate.parse("2024-02-29")
val resultDate = leapYearDate.minusYears(1)
println(resultDate)

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

kotlinString "2023-02-28"

Пример

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

kotlinval date = LocalDate.parse("2025-12-31")
val modifiedDate = date.minusYears(3)

val year = modifiedDate.year
val month = modifiedDate.monthValue
val day = modifiedDate.dayOfMonth

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

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

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

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

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