Функция minus

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

Импорт

kotlinimport java.time.Period

Синтаксис

kotlinfun minus(amount: TemporalAmount): Period

kotlinfun minus(amountToSubtract: Long, unit: TemporalUnit): Period

kotlinfun minusYears(yearsToSubtract: Long): Period

kotlinfun minusMonths(monthsToSubtract: Long): Period

kotlinfun minusDays(daysToSubtract: Long): Period

Пример

Вычтем один период из другого:

kotlinval period1 = Period.of(5, 8, 15)
val period2 = Period.of(2, 3, 7)
val result = period1.minus(period2)
println(result)

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

kotlinString "P3Y5M8D"

Пример

Вычтем отдельные компоненты из периода:

kotlinval period = Period.of(10, 6, 20)
val resultYears = period.minusYears(3)
val resultMonths = period.minusMonths(2)
val resultDays = period.minusDays(5)

println("After subtracting years: $resultYears")
println("After subtracting months: $resultMonths")
println("After subtracting days: $resultDays")

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

kotlinString "After subtracting years: P7Y6M20D"
String "After subtracting months: P10Y4M20D"
String "After subtracting days: P10Y6M15D"

Пример

Вычтем период с отрицательными значениями:

kotlinval period1 = Period.of(3, 2, 1)
val period2 = Period.of(-1, -1, -1)
val result = period1.minus(period2)
println(result)

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

kotlinString "P4Y3M2D"

Пример

Вычтем период из даты:

kotlinimport java.time.LocalDate

val date = LocalDate.of(2025, 12, 31)
val period = Period.of(1, 2, 15)
val newDate = date.minus(period)
println(newDate)

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

kotlinString "2024-10-16"

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