Метод appendLiteral

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

Импорт

import java.time.format.DateTimeFormatterBuilder

Синтаксис

fun appendLiteral(literal: CharSequence): DateTimeFormatterBuilder

Пример

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

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

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

String "Date: 2025-12-31"

Пример

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

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

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

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

Пример

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

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

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

String "2025-12-31"

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

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