Функция plusYears

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

Импорт

import java.time.YearMonth

Синтаксис

fun plusYears(yearsToAdd: Long): YearMonth

Пример

Добавим 2 года к объекту YearMonth:

val yearMonth = YearMonth.of(2025, 6)
val result = yearMonth.plusYears(2)
println(result)

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

String "2027-06"

Пример

Вычтем 3 года из объекта YearMonth:

val yearMonth = YearMonth.of(2025, 11)
val result = yearMonth.plusYears(-3)
println(result)

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

String "2022-11"

Пример

Добавим 0 лет к объекту YearMonth (получим тот же объект):

val yearMonth = YearMonth.of(2025, 3)
val result = yearMonth.plusYears(0)
println(result)
println(yearMonth == result)

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

String "2025-03"
Boolean true

Пример

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

val leapYear = YearMonth.of(2024, 2)
val result = leapYear.plusYears(1)

val leapDays = leapYear.lengthOfMonth()
val normalDays = result.lengthOfMonth()

println("Leap year days: $leapDays")
println("Normal year days: $normalDays")

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

String "Leap year days: 29"
String "Normal year days: 28"

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

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