Функция plusHours

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

Импорт

kotlinimport java.time.LocalDateTime

Синтаксис

kotlinfun plusHours(hours: Long): LocalDateTime

Пример

Добавим 5 часов к дате и времени "2025-03-15T10:30:00":

kotlinval dateTime = LocalDateTime.parse("2025-03-15T10:30:00")
val result = dateTime.plusHours(5)
println(result)

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

kotlinString "2025-03-15T15:30:00"

Пример

Добавим 24 часа (сутки) к дате и времени:

kotlinval dateTime = LocalDateTime.of(2025, 12, 31, 14, 0)
val result = dateTime.plusHours(24)
println(result)

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

kotlinString "2026-01-01T14:00:00"

Пример

Добавим отрицательное количество часов (вычтем 3 часа):

kotlinval dateTime = LocalDateTime.parse("2025-07-20T08:45:00")
val result = dateTime.plusHours(-3)
println(result)

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

kotlinString "2025-07-20T05:45:00"

Пример

Получим отдельные компоненты даты и времени после добавления часов:

kotlinval original = LocalDateTime.of(2025, 6, 10, 22, 30)
val modified = original.plusHours(4)

val hour = modified.hour
val day = modified.dayOfMonth

println("Hour: $hour, Day: $day")

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

kotlinString "Hour: 2, Day: 11"

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

  • функцию plusMinutes класса LocalDateTime,
    которая добавляет минуты к дате и времени
  • функцию minusHours класса LocalDateTime,
    которая вычитает часы из даты и времени
  • функцию withHour класса LocalDateTime,
    которая устанавливает конкретный час
  • функцию plusHours класса LocalTime,
    которая добавляет часы ко времени