Format（格式）

format 映射参数指定日期字段在索引期间可以接受的内置日期格式。通过定义预期的日期格式，您可以确保日期值被正确解析和存储，从而支持准确的搜索和聚合操作。

示例：定义自定义日期格式

创建一个 events 索引，其中 event_date 字段配置为自定义的 yyyy-MM-dd HH:mm:ss 日期格式：

PUT events
{
  "mappings": {
    "properties": {
      "event_date": {
        "type": "date",
        "format": "yyyy-MM-dd HH:mm:ss"
      }
    }
  }
}

使用指定的格式为 event_date 字段索引一个文档：

PUT events/_doc/1
{
  "event_name": "Conference",
  "event_date": "2025-03-26 15:30:00"
}

示例：使用多种日期格式

创建一个索引，其中包含 log_timestamp 字段，该字段同时接受自定义的 yyyy-MM-dd HH:mm:ss 日期格式和 epoch_millis 格式：

PUT logs
{
  "mappings": {
    "properties": {
      "log_timestamp": {
        "type": "date",
        "format": "yyyy-MM-dd HH:mm:ss||epoch_millis"
      }
    }
  }
}

使用自定义格式索引第一个文档：

PUT logs/_doc/1
{
  "message": "System rebooted",
  "log_timestamp": "2025-03-26 08:45:00"
}

使用毫秒格式索引第二个文档：

PUT logs/_doc/2
{
  "message": "System updated",
  "log_timestamp": 1711442700000
}

内置日期格式

有关内置日期格式的完整列表，请参阅内置格式。