Функция plus

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

Импорт

import java.time.OffsetDateTime
import java.time.temporal.ChronoUnit

Синтаксис

fun plus(amountToAdd: Long, unit: TemporalUnit): OffsetDateTime

fun plus(amount: TemporalAmount): OffsetDateTime

Пример

Добавим 5 дней к дате и времени со смещением:

val dateTime = OffsetDateTime.parse("2025-03-15T10:30:00+03:00")
val result = dateTime.plus(5, ChronoUnit.DAYS)
println(result)

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

String "2025-03-20T10:30:00+03:00"

Пример

Добавим 2 часа к дате и времени со смещением:

val dateTime = OffsetDateTime.parse("2025-07-20T14:45:00+02:00")
val result = dateTime.plus(2, ChronoUnit.HOURS)
println(result)

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

String "2025-07-20T16:45:00+02:00"

Пример

Добавим период в 1 месяц и 10 дней с помощью TemporalAmount:

import java.time.Period

val dateTime = OffsetDateTime.parse("2025-01-10T08:00:00-05:00")
val period = Period.of(0, 1, 10)
val result = dateTime.plus(period)
println(result)

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

String "2025-02-20T08:00:00-05:00"

Пример

Добавим продолжительность в 90 минут с помощью Duration:

import java.time.Duration

val dateTime = OffsetDateTime.parse("2025-12-31T23:30:00+01:00")
val duration = Duration.ofMinutes(90)
val result = dateTime.plus(duration)
println(result)

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

String "2026-01-01T01:00:00+01:00"

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

функцию minus класса OffsetDateTime,
которая вычитает указанное количество времени