› › ›

Процессор дат

Парсит даты из полей и затем использует дату или метку времени как метку времени документа. По умолчанию процессор дат добавляет разобранную дату как новое поле, называемое @timestamp. Можно указать другое поле, задав параметр конфигурации target_field. Поддерживаются несколько форматов дат в рамках одного определения процессора дат. Они будут использоваться последовательно для попытки парсинга поля даты в том же порядке, в котором они были определены в рамках определения процессора.

Таблица 10. Параметры дат

Имя	Обязательно	По умолчанию	Описание
`field`	да	-	Поле, из которого нужно получить дату.
`target_field`	нет	@timestamp	Поле, которое будет содержать разобранную дату.
`formats`	да	-	Массив ожидаемых форматов дат. Может быть паттерном java time или одним из следующих форматов: ISO8601, UNIX, UNIX_MS или TAI64N.
`timezone`	нет	UTC	Часовой пояс, используемый при разборе даты. Поддерживает фрагменты шаблонов.
`locale`	нет	ENGLISH	Локаль, используемая при разборе даты, релевантна при разборе названий месяцев или дней недели. Поддерживает фрагменты шаблонов.
`output_format`	нет	`yyyy-MM-dd'T'HH:mm:ss.SSSXXX`	Формат, используемый при записи даты в `target_field`. Может быть паттерном java time или одним из следующих форматов: ISO8601, UNIX, UNIX_MS или TAI64N.
`description`	нет	-	Описание процессора. Полезно для описания цели процессора или его конфигурации.
`if`	нет	-	Условное выполнение процессора. См. Условное выполнение процессора.
`ignore_failure`	нет	`false`	Игнорировать ошибки для процессора. См. Обработка ошибок пайплайна.
`on_failure`	нет	-	Обработка ошибок для процессора. См. Обработка ошибок пайплайна.
`tag`	нет	-	Идентификатор процессора. Полезен для отладки и метрик.

Вот пример, который добавляет разобранную дату в поле timestamp на основе поля initial_date:

{
  "description" : "...",
  "processors" : [
    {
      "date" : {
        "field" : "initial_date",
        "target_field" : "timestamp",
        "formats" : ["dd/MM/yyyy HH:mm:ss"],
        "timezone" : "Europe/Amsterdam"
      }
    }
  ]
}

Параметры процессора timezone и locale являются шаблонизированными. Это означает, что их значения можно извлечь из полей в документах. Приведенный ниже пример показывает, как извлечь сведения о локали/часовом поясе из существующих полей, my_timezone и my_locale, в документе, содержащем значения часового пояса и локали.

{
  "description" : "...",
  "processors" : [
    {
      "date" : {
        "field" : "initial_date",
        "target_field" : "timestamp",
        "formats" : ["ISO8601"],
        "timezone" : "{{{my_timezone}}}",
        "locale" : "{{{my_locale}}}"
      }
    }
  ]
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/date-processor.html