Функция range

Функция range класса Year возвращает объект ValueRange, который представляет допустимый диапазон значений для указанного поля. В параметр мы передаем поле временной единицы, для которого нужно получить диапазон значений.

Импорт

import java.time.Year
import java.time.temporal.ChronoField

Синтаксис

fun range(field: TemporalField): ValueRange

Пример

Получим диапазон дней в 2025 году:

val year = Year.of(2025)
val dayRange = year.range(ChronoField.DAY_OF_YEAR)

println("Day of year range: $dayRange")

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

String "Day of year range: 1 - 365"

Пример

Получим диапазон дней в високосном году:

val leapYear = Year.of(2024)
val leapDayRange = leapYear.range(ChronoField.DAY_OF_YEAR)

println("Leap year day range: $leapDayRange")

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

String "Leap year day range: 1 - 366"

Пример

Получим диапазон месяцев в году:

val year = Year.of(2025)
val monthRange = year.range(ChronoField.MONTH_OF_YEAR)

println("Month of year range: $monthRange")

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

String "Month of year range: 1 - 12"

Пример

Проверим, является ли значение допустимым для дня года:

val year = Year.of(2025)
val dayRange = year.range(ChronoField.DAY_OF_YEAR)

val isValidDay365 = dayRange.isValidValue(365)
val isValidDay366 = dayRange.isValidValue(366)

println("Day 365 valid: $isValidDay365")
println("Day 366 valid: $isValidDay366")

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

String "Day 365 valid: true"
String "Day 366 valid: false"

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

функцию isLeap класса Year,
которая проверяет, является ли год високосным
функцию length класса Year,
которая возвращает количество дней в году
функцию isValidValue класса ValueRange,
которая проверяет допустимость значения в диапазоне
поле DAY_OF_YEAR класса ChronoField,
которое представляет день года