Функция plusYears

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

Импорт

kotlinimport java.time.LocalDate

Синтаксис

kotlinfun plusYears(yearsToAdd: Long): LocalDate

Пример

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

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

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

kotlinString "2027-03-15"

Пример

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

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

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

kotlinString "2020-08-20"

Пример

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

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

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

kotlinString "2025-02-28"

Пример

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

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

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

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

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