ElasticSearch数据类型Date介绍

xdd

发布于 2022-07-12 14:24:07

1.8K0

发布于 2022-07-12 14:24:07

文章被收录于专栏：java技术鸡汤java技术鸡汤

本文主要简单介绍ES中的数据类型Date相关概念，希望对大家学习和理解ES有所帮助。

JSON并没有提供一种date数据类型，所以在elasticsearch中的date类型可以是下面的形式：

格式化好的字符串，比如"2015-01-01"，"2015/01/01 12:10:30"
一个long类型整数，代表从纪元以来的毫秒数
一个integer类型整数，表示从纪元开始的秒数

注意：

long和integer必须是非负数
使用带格式的日期表示1970年之前的日期

在内部，日期会转换为UTC（如果指定了时区），并存储为一个整数，表示自纪元以来的毫秒数。

日期查询会在内部转换为这种长表示形式的范围查询，并且聚合和存储字段的结果将转换为字符串，具体取决于与该字段关联的日期格式。

日期将始终以字符串形式呈现，即使最初在JSON文档中提供的日期很长也是如此。

日期格式可以自定义，但如果未指定格式，则使用默认格式：

"strict_date_optional_time||epoch_millis"

这意味着它将接受带有可选时间戳记的日期，该时间戳记与strict_date_optional_time或毫秒（自纪元）支持的格式一致。

curl -X PUT "localhost:9200/my-index-000001?pretty" -H 'Content-Type: application/json' -d'
{
  "mappings": {
    "properties": {
      "date": {
        // 使用默认的date. format格式
        "type": "date" 
      }
    }
  }
}
'

curl -X PUT "localhost:9200/my-index-000001/_doc/1?pretty" -H 'Content-Type: application/json' -d'
// 使用一个简单的日期格式
{ "date": "2015-01-01" }
'

curl -X PUT "localhost:9200/my-index-000001/_doc/2?pretty" -H 'Content-Type: application/json' -d'
// 带有时间的格式
{ "date": "2015-01-01T12:10:30Z" }
'

curl -X PUT "localhost:9200/my-index-000001/_doc/3?pretty" -H 'Content-Type: application/json' -d'
// 自纪元以来的毫秒数。
{ "date": 1420070400001 }
'

curl -X GET "localhost:9200/my-index-000001/_search?pretty" -H 'Content-Type: application/json' -d'
{
  //请注意，返回的排序值都自毫秒起（以毫秒为单位）。
  "sort": { "date": "asc"} 
}
'

多种日期格式

可以使用||分隔指定多种格式作为分隔符。依次尝试每种格式，直到找到匹配的格式。第一种格式将用于将毫秒数（从纪元开始）转换回字符串。

curl -X PUT "localhost:9200/my-index-000001?pretty" -H 'Content-Type: application/json' -d'
{
  "mappings": {
    "properties": {
      "date": {
        "type":   "date",
        "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
      }
    }
  }
}
'