Функция checkValidValue

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

Импорт

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

Синтаксис

fun checkValidValue(value: Long): Long

Пример

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

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

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

String "Valid value: 12"

Пример

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

val 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}")
}

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

String "Error: Invalid value for HourOfDay: 25"

Пример

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

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

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

String "Valid day: 29"

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

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