Функция withYears

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

Импорт

import java.time.Period

Синтаксис

fun withYears(years: Int): Period

Пример

Создадим период 2 года, 3 месяца и 10 дней, затем изменим количество лет на 5:

val period = Period.of(2, 3, 10)
val newPeriod = period.withYears(5)
println(newPeriod)

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

String "P5Y3M10D"

Пример

Установим отрицательное количество лет в периоде:

val period = Period.of(1, 6, 15)
val negativePeriod = period.withYears(-3)
println(negativePeriod)

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

String "P-3Y6M15D"

Пример

Используем withYears вместе с другими методами Period:

val original = Period.of(4, 8, 20)
val modified = original.withYears(7).withMonths(2)

val years = modified.years
val months = modified.months
val days = modified.days

println("Years: $years, Months: $months, Days: $days")

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

String "Years: 7, Months: 2, Days: 20"

Пример

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

val period = Period.of(10, 5, 30)
val zeroYearPeriod = period.withYears(0)

val isZeroYears = zeroYearPeriod.years == 0
val totalMonths = zeroYearPeriod.months
val totalDays = zeroYearPeriod.days

println("Is zero years: $isZeroYears")
println("Months: $totalMonths, Days: $totalDays")

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

String "Is zero years: true"
String "Months: 5, Days: 30"

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

функцию withMonths класса Period,
которая изменяет количество месяцев в периоде
функцию withDays класса Period,
которая изменяет количество дней в периоде
функцию of класса Period,
которая создает период из указанных лет, месяцев и дней
функцию getYears класса Period,
которая возвращает количество лет в периоде