Функция ofYears

Функция ofYears класса Period создает объект периода с указанным количеством лет. В параметр мы передаем целое число лет, которое может быть положительным или отрицательным.

Импорт

kotlinimport java.time.Period

Синтаксис

kotlinfun ofYears(years: Int): Period

Пример

Создадим период в 5 лет:

kotlinval period = Period.ofYears(5)
println(period)

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

kotlinString "P5Y"

Пример

Создадим отрицательный период в 3 года:

kotlinval period = Period.ofYears(-3)
println(period)

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

kotlinString "P-3Y"

Пример

Используем период для добавления к дате:

kotlinimport java.time.LocalDate

val date = LocalDate.of(2025, 6, 15)
val period = Period.ofYears(2)
val newDate = date.plus(period)

println("Original date: $date")
println("New date: $newDate")

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

kotlinString "Original date: 2025-06-15"
String "New date: 2027-06-15"

Пример

Создадим период с нулевым количеством лет:

kotlinval period = Period.ofYears(0)
println(period)

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

kotlinString "P0Y"

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

  • функцию ofMonths класса Period,
    которая создает период из месяцев
  • функцию ofDays класса Period,
    которая создает период из дней
  • функцию of класса Period,
    которая создает период из лет, месяцев и дней
  • функцию plusYears класса LocalDate,
    которая добавляет годы к дате