Константа ISO_LOCAL_DATE

Константа ISO_LOCAL_DATE класса DateTimeFormatter представляет предопределенный форматтер для даты в формате год-месяц-день согласно стандарту ISO-8601. Данный форматтер используется для парсинга строк в объекты LocalDate и форматирования дат в строки.

Импорт

kotlinimport java.time.format.DateTimeFormatter

Синтаксис

kotlinDateTimeFormatter.ISO_LOCAL_DATE

Пример

Используем ISO_LOCAL_DATE для парсинга строки "2025-12-31" в объект LocalDate:

kotlinimport java.time.LocalDate
import java.time.format.DateTimeFormatter

val dateStr = "2025-12-31"
val date = LocalDate.parse(dateStr, DateTimeFormatter.ISO_LOCAL_DATE)
println(date)

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

kotlinString "2025-12-31"

Пример

Используем ISO_LOCAL_DATE для форматирования объекта LocalDate в строку:

kotlinimport java.time.LocalDate
import java.time.format.DateTimeFormatter

val date = LocalDate.of(2025, 7, 15)
val formattedDate = date.format(DateTimeFormatter.ISO_LOCAL_DATE)
println(formattedDate)

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

kotlinString "2025-07-15"

Пример

Сравним использование ISO_LOCAL_DATE с прямым парсингом через parse:

kotlinimport java.time.LocalDate
import java.time.format.DateTimeFormatter

val dateStr = "2025-03-20"

// Способ 1: прямое использование parse
val date1 = LocalDate.parse(dateStr)

// Способ 2: с явным указанием форматтера
val date2 = LocalDate.parse(dateStr, DateTimeFormatter.ISO_LOCAL_DATE)

println("Date 1: $date1")
println("Date 2: $date2")
println("Dates equal: ${date1 == date2}")

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

kotlinString "Date 1: 2025-03-20"
String "Date 2: 2025-03-20"
String "Dates equal: true"

Пример

Используем ISO_LOCAL_DATE с методом parse класса DateTimeFormatter:

kotlinimport java.time.LocalDate
import java.time.format.DateTimeFormatter

val dateStr = "2025-08-10"
val parsedDate = DateTimeFormatter.ISO_LOCAL_DATE.parse(dateStr)
val date = LocalDate.from(parsedDate)
println(date)

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

kotlinString "2025-08-10"

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

  • константу ISO_LOCAL_DATE_TIME класса DateTimeFormatter,
    которая представляет форматтер для даты и времени
  • константу ISO_LOCAL_TIME класса DateTimeFormatter,
    которая представляет форматтер для времени
  • функцию ofPattern класса DateTimeFormatter,
    которая создает кастомный форматтер
  • класс LocalDate,
    который представляет дату без времени