Метод appendPattern

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

Импорт

kotlinimport java.time.format.DateTimeFormatterBuilder

Синтаксис

kotlinfun appendPattern(pattern: String): DateTimeFormatterBuilder

Пример

Создадим форматтер для даты в формате день/месяц/год:

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

val dateStr = "31/12/2025"
val parsedDate = java.time.LocalDate.parse(dateStr, formatter)
println(parsedDate)

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

kotlinString "2025-12-31"

Пример

Создадим форматтер для даты и времени с текстовым месяцем:

kotlinval builder = DateTimeFormatterBuilder()
builder.appendPattern("dd MMM yyyy HH:mm:ss")
val formatter = builder.toFormatter(java.util.Locale.ENGLISH)

val dateTimeStr = "31 Dec 2025 23:59:59"
val parsedDateTime = java.time.LocalDateTime.parse(dateTimeStr, formatter)
println(parsedDateTime)

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

kotlinString "2025-12-31T23:59:59"

Пример

Комбинируем несколько шаблонов с помощью appendPattern:

kotlinval builder = DateTimeFormatterBuilder()
builder.appendPattern("yyyy-MM-dd")
builder.appendLiteral("T")
builder.appendPattern("HH:mm:ss")
val formatter = builder.toFormatter()

val dateTimeStr = "2025-12-31T23:59:59"
val parsedDateTime = java.time.LocalDateTime.parse(dateTimeStr, formatter)
println(parsedDateTime)

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

kotlinString "2025-12-31T23:59:59"

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

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