Функция minus

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

Импорт

import java.time.ZonedDateTime
import java.time.Period
import java.time.Duration
import java.time.temporal.ChronoUnit

Синтаксис

fun minus(amountToSubtract: Long, unit: TemporalUnit): ZonedDateTime

fun minus(amount: TemporalAmount): ZonedDateTime

Пример

Вычтем 5 дней из даты-времени с часовым поясом:

val dateTime = ZonedDateTime.parse("2025-06-15T10:30:00+03:00[Europe/Moscow]")
val result = dateTime.minus(5, ChronoUnit.DAYS)
println(result)

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

String "2025-06-10T10:30:00+03:00[Europe/Moscow]"

Пример

Вычтем 2 часа из даты-времени:

val dateTime = ZonedDateTime.parse("2025-12-31T23:45:00+03:00[Europe/Moscow]")
val result = dateTime.minus(2, ChronoUnit.HOURS)
println(result)

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

String "2025-12-31T21:45:00+03:00[Europe/Moscow]"

Пример

Вычтем период из 1 месяца и 10 дней:

val dateTime = ZonedDateTime.parse("2025-03-20T15:20:00+03:00[Europe/Moscow]")
val period = Period.of(0, 1, 10)
val result = dateTime.minus(period)
println(result)

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

String "2025-02-10T15:20:00+03:00[Europe/Moscow]"

Пример

Вычтем длительность из 3 часов и 30 минут:

val dateTime = ZonedDateTime.parse("2025-07-01T18:00:00+03:00[Europe/Moscow]")
val duration = Duration.ofHours(3).plusMinutes(30)
val result = dateTime.minus(duration)
println(result)

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

String "2025-07-01T14:30:00+03:00[Europe/Moscow]"

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

функцию plus класса ZonedDateTime,
которая добавляет период или единицу времени к дате-времени
функцию with класса ZonedDateTime,
которая устанавливает конкретное значение поля даты-времени
класс Period,
который представляет период времени в годах, месяцах и днях
класс Duration,
который представляет длительность времени в часах, минутах и секундах