elasticsearch 之时间类型

日期类型（Date datatype）

JSON 没有日期类型，因此在 Elasticsearch 中可以表达成:

• 日期格式化的字符串，比如: “2015-01-01” 或者 “2015/01/01 12:10:30”;
• 毫秒级别的 long 类型
• 秒级别的 integer 类型，

比如: 1515150699465, 1515150699;
实际上不管日期以何种格式写入，在 ES 内部都会先换成 UTC 时间并存储为 long 类型。

日期格式可以自定义，如果没有指定的话会使用以下的默认格式:
“strict_date_optional_time||epoch_millis”

date 类型的查询在内部转为 long 处理，聚合返回的结果再根据字段定义的格式转为字符串输出。

注： 日期将始终呈现为字符串，即使它们最初是在 JSON 文档中作为 long 串提供的。

日期格式自定义，如果没有格式指定，它会使用以下默认设置：

"strict_date_optional_time||epoch_millis"

如：

PUT my_index
{
  "mappings": {
    "_doc": {
      "properties": {
        "date": {
          "type": "date" 
        }
      }
    }
  }
}

PUT my_index/_doc/1
{ "date": "2015-01-01" } 

PUT my_index/_doc/2
{ "date": "2015-01-01T12:10:30Z" } 

PUT my_index/_doc/3
{ "date": 1420070400001 } 

GET my_index/_search
{
  "sort": { "date": "asc"} 
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

注：sort 返回为数组，值均为毫秒时间戳。

多日期格式设置

PUT my_index
{
  "mappings": {
    "_doc": {
      "properties": {
        "date": {
          "type":   "date",
          "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
        }
      }
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

设置参数

• boost 默认 1.0
• doc_values 默认 true
• format 默认 strict_date_optional_time||epoch_millis
• locale
• ignore_malformed 是否忽略非正常格式的值，默认 false，抛出异常
• index 是否可被查询 默认 true
• null_value 默认值 null
• store 默认 false

常用 format

• epoch_millis
• epoch_second

参考

1.https://www.elastic.co/guide/en/elasticsearch/reference/6.4/date.html
2.https://www.elastic.co/guide/en/elasticsearch/reference/6.4/mapping-date-format.html