Метод appendLiteral

Метод appendLiteral класса DateTimeFormatterBuilder добавляет литерал (фиксированную строку) в шаблон форматтера. В параметр мы передаем строковый литерал, который должен быть включен в формат при парсинге и форматировании даты и времени.

Импорт

kotlinimport java.time.format.DateTimeFormatterBuilder

Синтаксис

kotlinfun appendLiteral(literal: CharSequence): DateTimeFormatterBuilder

Пример

Создадим форматтер с литералом "Date: " перед датой:

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

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

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

kotlinString "Date: 2025-12-31"

Пример

Добавим несколько литералов в форматтер для создания сложного шаблона:

kotlinval builder = DateTimeFormatterBuilder()
builder.appendLiteral("Year: ")
builder.appendPattern("yyyy")
builder.appendLiteral(", Month: ")
builder.appendPattern("MM")
builder.appendLiteral(", Day: ")
builder.appendPattern("dd")
val formatter = builder.toFormatter()

val date = java.time.LocalDate.of(2025, 7, 15)
val result = date.format(formatter)
println(result)

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

kotlinString "Year: 2025, Month: 07, Day: 15"

Пример

Используем литералы с парсингом даты:

kotlinval builder = DateTimeFormatterBuilder()
builder.appendLiteral("Date is: ")
builder.appendPattern("dd/MM/yyyy")
val formatter = builder.toFormatter()

val dateStr = "Date is: 31/12/2025"
val date = java.time.LocalDate.parse(dateStr, formatter)
println(date)

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

kotlinString "2025-12-31"

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