Функция withHour

Функция withHour класса LocalDateTime возвращает копию исходного объекта даты-времени с измененным значением часа. В параметр мы передаем целое число от 0 до 23, представляющее новый час.

Импорт

kotlinimport java.time.LocalDateTime

Синтаксис

kotlinfun withHour(hour: Int): LocalDateTime

Пример

Создадим объект LocalDateTime и изменим в нем час:

kotlinval dateTime = LocalDateTime.of(2025, 12, 31, 15, 30, 45)
val newDateTime = dateTime.withHour(20)
println("Original: $dateTime")
println("Modified: $newDateTime")

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

kotlinString "Original: 2025-12-31T15:30:45"
String "Modified: 2025-12-31T20:30:45"

Пример

Установим полночь (0 часов) для существующей даты-времени:

kotlinval dateTime = LocalDateTime.parse("2025-07-15T14:25:30")
val midnightDateTime = dateTime.withHour(0)
println(midnightDateTime)

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

kotlinString "2025-07-15T00:25:30"

Пример

Использование withHour в цепочке с другими методами изменения времени:

kotlinval dateTime = LocalDateTime.now()
val modifiedDateTime = dateTime
  .withHour(18)
  .withMinute(0)
  .withSecond(0)
println(modifiedDateTime)

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

kotlinString "2025-09-10T18:00:00"

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

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