Функция checkValidValue

Функция checkValidValue интерфейса TemporalField проверяет, находится ли переданное значение в допустимом диапазоне для данного временного поля. В параметр мы передаем значение типа Long для проверки, функция возвращает это же значение, если оно допустимо, или выбрасывает исключение DateTimeException, если значение выходит за пределы допустимого диапазона.

Импорт

kotlinimport java.time.temporal.TemporalField
import java.time.temporal.ChronoField

Синтаксис

kotlinfun checkValidValue(value: Long): Long

Пример

Проверим допустимость значения 12 для поля ChronoField.HOUR_OF_DAY:

kotlinval field = ChronoField.HOUR_OF_DAY
val value = 12L
val result = field.checkValidValue(value)
println("Valid value: $result")

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

kotlinString "Valid value: 12"

Пример

Попытаемся проверить недопустимое значение 25 для поля ChronoField.HOUR_OF_DAY:

kotlinval field = ChronoField.HOUR_OF_DAY
val value = 25L

try {
  val result = field.checkValidValue(value)
  println("Valid value: $result")
} catch (e: Exception) {
  println("Error: ${e.message}")
}

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

kotlinString "Error: Invalid value for HourOfDay: 25"

Пример

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

kotlinval field = ChronoField.DAY_OF_MONTH
val value = 29L
val result = field.checkValidValue(value)
println("Valid day: $result")

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

kotlinString "Valid day: 29"

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

  • функцию checkValidIntValue класса ChronoField,
    которая проверяет допустимость значения типа Int
  • функцию checkValidValue класса ValueRange,
    которая проверяет значение в диапазоне
  • поле DAY_OF_MONTH класса ChronoField,
    которое представляет день месяца
  • поле HOUR_OF_DAY класса ChronoField,
    которое представляет час дня