Функция withDayOfYear

Функция withDayOfYear класса LocalDateTime устанавливает день года для объекта даты и времени. В параметр мы передаем номер дня в году от 1 до 365 или 366 для високосного года. Функция возвращает новый объект LocalDateTime с измененным днем года, сохраняя время неизменным.

Импорт

kotlinimport java.time.LocalDateTime

Синтаксис

kotlinfun withDayOfYear(dayOfYear: Int): LocalDateTime

Пример

Установим 100-й день года для даты "2025-03-15T10:30:00":

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

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

kotlinString "2025-04-10T10:30:00"

Пример

Установим 366-й день года для високосного 2024 года:

kotlinval dateTime = LocalDateTime.of(2024, 6, 15, 14, 30, 45)
val result = dateTime.withDayOfYear(366)
println(result)

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

kotlinString "2024-12-31T14:30:45"

Пример

Проверим обработку недопустимых значений дня года:

kotlinval dateTime = LocalDateTime.parse("2025-01-01T00:00:00")

try {
  val result = dateTime.withDayOfYear(400)
  println(result)
} catch (e: Exception) {
  println("Error: " + e.message)
}

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

kotlinString "Error: Invalid value for DayOfYear: 400"

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

  • функцию withYear класса LocalDateTime,
    которая устанавливает год для даты и времени
  • функцию withMonth класса LocalDateTime,
    которая устанавливает месяц для даты и времени
  • функцию withDayOfMonth класса LocalDateTime,
    которая устанавливает день месяца для даты и времени
  • функцию withDayOfYear класса LocalDate,
    которая устанавливает день года только для даты