Функция minusYears

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

Импорт

import java.time.LocalDate

Синтаксис

fun minusYears(yearsToSubtract: Long): LocalDate

Пример

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

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

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

String "2020-03-15"

Пример

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

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

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

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

Пример

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

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

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

String "2023-02-28"

Пример

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

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

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

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

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

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