Elasticsearch 日期数据类型_elasticsearch 日期类型

前言

JSON没有表达日期的数据类型，所以在ES里面日期只能是下面其中之一：

• 格式化的日期字符串，比如："2015-01-01" or "2015/01/01 12:10:30"
• 用数字表示的从新纪元开始的毫秒数
• 用数字表示的从新纪元开始的秒数（epoch_second）

注意点：毫秒数的值是不能为负数的，如果时间在1970年以前，需要使用格式化的日期表达

在ES的内部，时间会被转换为UTC时间（如果声明了时区）并使用从新纪元开始的毫秒数的长整形数字类型的进行存储。

在日期字段上的查询，内部将会转换为使用长整形的毫秒进行范围查询，根据与字段关联的日期格式，聚合和存储字段的结果将转换回字符串。

        注意点：日期最终都会作为字符串呈现，即使最开始初始化的时候是利用JSON文档的long声明的。

日期的格式可以被定制化的，如果没有声明日期的格式，它将会使用默认的格式：

"strict_date_optional_time||epoch_millis"

这意味着它将会接收带时间戳的日期，它将遵守strict_date_optional_time 限定的格式（yyyy-MM-dd'T'HH:mm:ss.SSSZ 或者 yyyy-MM-dd）或者毫秒数

样例：

PUT my-index-000001
{
  "mappings": {
    "properties": {
      "date": {
        "type": "date" 
      }
    }
  }
}
 
PUT my-index-000001/_doc/1
{ "date": "2015-01-01" } 
 
PUT my-index-000001/_doc/2
{ "date": "2015-01-01T12:10:30Z" } 
 
PUT my-index-000001/_doc/3
{ "date": 1420070400001 } 
 
GET my-index-000001/_search
{
  "sort": { "date": "asc"} 
}

说明：

1. "type": "date" date字段使用默认的格式

2. "date": "2015-01-01"：只包含了日期，没有时间

3. "date": "2015-01-01T12:10:30Z"：包含了时间部分

4. "date": 1420070400001：利用毫秒数来传输

5. "sort": { "date": "asc"} ：返回的排序值均以毫秒为单位

注意点：日期类型的数据可以接收十进制的小数，例如{"date": 1618249875.123456}，但是这会导致一些情况下精度丢失，所以我们尽量避免这样用。

多日期格式：

可以使用||分隔符来声明多种格式的日期，将依次尝试每种格式，直到找到匹配的格式。第一种格式将会被用来把存储的毫秒数转化为字符串，样例如下：

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

date数据类型的参数：

下面表格里的参数可以用在date字段上面：

按秒存储

        如果我们需要按秒存储数据，则可以这样设置：

PUT my-index-000001
{
  "mappings": {
    "properties": {
      "date": {
        "type":   "date",
        "format": "strict_date_optional_time||epoch_second"
      }
    }
  }
}
 
PUT my-index-000001/_doc/example?refresh
{ "date": 1618321898 }
 
POST my-index-000001/_search
{
  "fields": [ {"field": "date"}],
  "_source": false
}

这个时候查询到的结果如下：

{
  "hits": {
    "hits": [
      {
        "_id": "example",
        "_index": "my-index-000001",
        "_score": 1.0,
        "fields": {
          "date": ["2021-04-13T13:51:38.000Z"]
        }
      }
    ]
  }
}