Функция plusHours

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun plusHours(hours: Long): LocalDateTime

Пример

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

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

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

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

Пример

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

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

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

String "2026-01-01T14:00:00"

Пример

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

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

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

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

Пример

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

val 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")

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

String "Hour: 2, Day: 11"

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

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