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字段上面：

参数	说明
doc_values	该字段是否按照列式存储在磁盘上以便于后续进行排序、聚合和脚本操作，可配置 true（默认）或 false
format	日期的格式
locale	解析日期中时使用了本地语言表示月份时的名称和/或缩写，默认是 ROOT locale
ignore_malformed	如果设置为true，则奇怪的数字就会被忽略，如果是false（默认）奇怪的数字就会导致异常并且该文档将会被拒绝写入。需要注意的是，如果在脚本参数中使用则该属性不能被设置
index	该字段是否能快速的被查询，默认是true。date类型的字段只有在doc_values设置为true时才能被查询，尽管很慢。
null_value	替代null的值，默认是null
on_script_error	定义在脚本中如何处理抛出的异常，fail（默认）则整个文档会被拒绝索引，continue：继续索引
script	如果该字段被设置，则字段的值将会使用该脚本产生，而不是直接从source里面读取。
store	true or false(默认)是否在 _source 之外在独立存储一份
meta

按秒存储

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

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"]
        }
      }
    ]
  }
}