Метод appendChronology

Метод appendChronology класса DateTimeFormatterBuilder добавляет поле хронологии в форматтер даты и времени. Этот метод позволяет включать информацию о календарной системе в отформатированную строку даты.

Импорт

kotlinimport java.time.format.DateTimeFormatterBuilder

Синтаксис

kotlinfun appendChronology(): DateTimeFormatterBuilder

Пример

Создадим форматтер с хронологией и отформатируем дату:

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

val builder = DateTimeFormatterBuilder()
val formatter = builder.appendChronology().appendLiteral(" ").appendPattern("yyyy-MM-dd").toFormatter()

val date = LocalDate.of(2025, 12, 31)
val result = date.format(formatter)
println(result)

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

kotlinString "ISO 2025-12-31"

Пример

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

kotlinimport java.time.LocalDateTime
import java.time.format.DateTimeFormatter
import java.time.format.DateTimeFormatterBuilder

val builder = DateTimeFormatterBuilder()
val formatter = builder.appendChronology()
  .appendLiteral(" | ")
  .appendPattern("dd.MM.yyyy HH:mm")
  .toFormatter()

val dateTime = LocalDateTime.of(2025, 7, 15, 14, 30)
val result = dateTime.format(formatter)
println(result)

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

kotlinString "ISO | 15.07.2025 14:30"

Пример

Парсинг строки с информацией о хронологии:

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

val builder = DateTimeFormatterBuilder()
val formatter = builder.appendChronology().appendLiteral(" ").appendPattern("yyyy-MM-dd").toFormatter()

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

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

kotlinString "2025-12-31"

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

  • метод appendPattern класса DateTimeFormatterBuilder,
    который добавляет шаблон форматирования
  • метод appendLiteral класса DateTimeFormatterBuilder,
    который добавляет литерал в форматтер
  • метод toFormatter класса DateTimeFormatterBuilder,
    который создает форматтер из билдера
  • класс DateTimeFormatter,
    который представляет форматтер даты и времени