Функция plusYears

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun plusYears(years: Long): LocalDateTime

Пример

Добавим 2 года к дате и времени "2025-03-15T10:30:00":

val originalDateTime = LocalDateTime.parse("2025-03-15T10:30:00")
val newDateTime = originalDateTime.plusYears(2)
println(newDateTime)

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

String "2027-03-15T10:30:00"

Пример

Добавим 5 лет к текущей дате и времени:

val currentDateTime = LocalDateTime.now()
val futureDateTime = currentDateTime.plusYears(5)
println("Current: $currentDateTime")
println("Future: $futureDateTime")

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

String "Current: 2025-01-01T12:00:00"
String "Future: 2030-01-01T12:00:00"

Пример

Добавим отрицательное количество лет (вычтем 3 года):

val dateTime = LocalDateTime.parse("2025-06-20T15:45:00")
val pastDateTime = dateTime.plusYears(-3)
println(pastDateTime)

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

String "2022-06-20T15:45:00"

Пример

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

val leapYearDate = LocalDateTime.parse("2024-02-29T00:00:00")
val nextYearDate = leapYearDate.plusYears(1)
println(nextYearDate)

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

String "2025-02-28T00:00:00"

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

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