Константа YEAR

Константа YEAR класса ChronoField представляет поле года в временных объектах. Она используется для получения или изменения значения года через методы get и with временных объектов.

Импорт

kotlinimport java.time.temporal.ChronoField

Синтаксис

kotlinChronoField.YEAR

Пример

Получим значение года из объекта LocalDate:

kotlinimport java.time.LocalDate
import java.time.temporal.ChronoField

val date = LocalDate.of(2025, 12, 31)
val year = date.get(ChronoField.YEAR)
println("Year: $year")

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

kotlinString "Year: 2025"

Пример

Изменим значение года в объекте LocalDate:

kotlinimport java.time.LocalDate
import java.time.temporal.ChronoField

val date = LocalDate.of(2025, 12, 31)
val newDate = date.with(ChronoField.YEAR, 2030)
println("New date: $newDate")

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

kotlinString "New date: 2030-12-31"

Пример

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

kotlinimport java.time.temporal.ChronoField

val isValid = ChronoField.YEAR.isValidValue(2025)
println("Is valid: $isValid")

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

kotlinString "Is valid: true"

Пример

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

kotlinimport java.time.LocalDate
import java.time.temporal.ChronoField

val date = LocalDate.of(2025, 12, 31)
val range = ChronoField.YEAR.rangeRefinedBy(date)
val minYear = range.minimum
val maxYear = range.maximum

println("Min year: $minYear, Max year: $maxYear")

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

kotlinString "Min year: -999999999, Max year: 999999999"

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

  • константу MONTH_OF_YEAR класса ChronoField,
    которая представляет поле месяца
  • константу DAY_OF_MONTH класса ChronoField,
    которая представляет поле дня месяца
  • функцию getYear класса LocalDate,
    которая возвращает значение года
  • функцию withYear класса LocalDate,
    которая изменяет значение года