Функция plusYears

Функция plusYears класса LocalDate добавляет указанное количество лет к текущей дате и возвращает новый объект LocalDate. В параметр мы передаем количество лет для добавления (может быть отрицательным для вычитания). Функция учитывает високосные годы и корректно обрабатывает 29 февраля.

Импорт

import java.time.LocalDate

Синтаксис

fun plusYears(yearsToAdd: Long): LocalDate

Пример

Добавим 2 года к дате "2025-03-15":

val date = LocalDate.parse("2025-03-15")
val newDate = date.plusYears(2)
println(newDate)

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

String "2027-03-15"

Пример

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

val date = LocalDate.parse("2025-08-20")
val newDate = date.plusYears(-5)
println(newDate)

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

String "2020-08-20"

Пример

Проверим обработку високосного года с 29 февраля:

val leapDate = LocalDate.of(2024, 2, 29)
val nextYearDate = leapDate.plusYears(1)
println(nextYearDate)

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

String "2025-02-28"

Пример

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

val originalDate = LocalDate.parse("2025-11-10")
val futureDate = originalDate.plusYears(10)

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

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

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

String "Year: 2035, Month: 11, Day: 10"

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

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