Функция plusYears

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

Импорт

kotlinimport java.time.YearMonth

Синтаксис

kotlinfun plusYears(yearsToAdd: Long): YearMonth

Пример

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

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

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

kotlinString "2027-06"

Пример

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

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

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

kotlinString "2022-11"

Пример

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

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

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

kotlinString "2025-03"
Boolean true

Пример

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

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

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

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

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

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