Функция withHour

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun withHour(hour: Int): LocalDateTime

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

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

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