Константа ISO_DATE

Константа ISO_DATE класса DateTimeFormatter предоставляет форматтер для даты в формате год-месяц-день с возможностью включения смещения часового пояса. Форматтер может использоваться для парсинга и форматирования дат в соответствии со стандартом ISO-8601.

Импорт

kotlinimport java.time.format.DateTimeFormatter

Синтаксис

kotlinDateTimeFormatter.ISO_DATE

Пример

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

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

val date = LocalDate.of(2025, 12, 31)
val formatted = date.format(DateTimeFormatter.ISO_DATE)
println(formatted)

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

kotlinString "2025-12-31"

Пример

Используем ISO_DATE для парсинга строки с датой:

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

val dateStr = "2025-07-15"
val date = LocalDate.parse(dateStr, DateTimeFormatter.ISO_DATE)
println(date)

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

kotlinString "2025-07-15"

Пример

Сравним ISO_DATE с ISO_LOCAL_DATE:

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

val date = LocalDate.of(2025, 12, 31)

val isoDate = date.format(DateTimeFormatter.ISO_DATE)
val isoLocalDate = date.format(DateTimeFormatter.ISO_LOCAL_DATE)

println("ISO_DATE: $isoDate")
println("ISO_LOCAL_DATE: $isoLocalDate")

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

kotlinString "ISO_DATE: 2025-12-31"
String "ISO_LOCAL_DATE: 2025-12-31"

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

  • константу ISO_LOCAL_DATE класса DateTimeFormatter,
    которая форматирует дату без смещения часового пояса
  • константу ISO_DATE_TIME класса DateTimeFormatter,
    которая форматирует дату и время с возможностью включения смещения часового пояса
  • функцию ofPattern класса DateTimeFormatter,
    которая создает кастомный форматтер
  • класс LocalDate,
    который представляет дату без времени и часового пояса