Функция plusYears

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

Импорт

kotlinimport java.time.LocalDateTime

Синтаксис

kotlinfun plusYears(years: Long): LocalDateTime

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

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