Функция withDayOfYear

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun withDayOfYear(dayOfYear: Int): LocalDateTime

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

String "Error: Invalid value for DayOfYear: 400"

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

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