格式
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
}
内置日期格式
有关内置日期格式的完整列表,请参阅内置格式。