elasticsearch日期类型_es存储日期 utc

译自官方文档，原文请戳这里。

JSON中没有date类型，因此 es 中的日期可以是：

“2015-01-01” “2015/01/01 12:10:30” 这种字符串格式

从开始纪元(1970年1月1日0点) 开始的毫秒数

从开始纪元开始的秒数

es 会自动将时间转换为UTC(你也可以自定义时区 time-zone)，并最终存储为一个代表从开始纪元起计算的毫秒数。

对日期的查询会被自动转换为针对此long类型的查询，而聚合之后的查询结果会依据该field指定的格式重新转为String格式。

注意：日期最终都渲染为字符串，即使它们的初始格式在JSON中是long格式。

Date也可以自定义，但如果你没有指定format，es将使用默认值：

“strict_date_optional_time||epoch_millis”

date支持可选的时间戳，具体格式为 strict_date_optional_time 或 milliseconds-since-the-epoch。示例如下：

PUT my_index

{

“mappings”: {

“_doc”: {

“properties”: {

“date”: {

“type”: “date” // 1

}

}

}

}

}

PUT my_index/_doc/1

{ “date”: “2015-01-01” } // 2

PUT my_index/_doc/2

{ “date”: “2015-01-01T12:10:30Z” } // 3

PUT my_index/_doc/3

{ “date”: 1420070400001 } // 4

GET my_index/_search

{

“sort”: { “date”: “asc”} // 5

}

1 使用默认格式

2 使用简单date

3 使用带 time 的 date

4 使用毫秒偏移量

5 sort 返回的日期格式全部都是毫秒偏移量

多日期格式

你可以使用 || 分隔符来指定多个日期格式。es将按顺序进行匹配，直到找到一个能够匹配上的格式。es将用此格式将long转为string。

PUT my_index

{

“mappings”: {

“_doc”: {

“properties”: {

“date”: {

“type”: “date”,

“format”: “yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis”

}

}

}

}

}

date类型field的参数

date类型的field接受以下参数：

提升查询权重。浮点型，默认值 1.0

是否使用doc_values。如果确定不需要对此field进行排序/聚合，或者使用脚本，可以关闭。默认true

日期格式。默认 strict_date_optional_time || epoch_millis

locale

用于解决月份在各语言中没有统一缩写的问题。默认值为 ROOT

当设置为true时将忽略错误数字。如果设置为false，遇到错误时将抛出异常并拒绝掉整个document

如果该字段可以被搜索，请设置为true。默认为true

当输入值为空时，使用该值来代替，必须为format参数格式。默认为null，意味着该字段丢失

字段值是否应该在_source字段之外存储和检索。默认false。