Метод appendChronology

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

Импорт

import java.time.format.DateTimeFormatterBuilder

Синтаксис

fun appendChronology(): DateTimeFormatterBuilder

Пример

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

import 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)

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

String "ISO 2025-12-31"

Пример

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

import 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)

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

String "ISO | 15.07.2025 14:30"

Пример

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

import 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)

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

String "2025-12-31"

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

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