date 字段类型
JSON 没有日期数据类型,因此 Elasticsearch 中的日期可以是:
- 包含格式化日期的字符串,例如
"2015-01-01"或"2015/01/01 12:10:30"。 - 表示自纪元(epoch)以来的毫秒数的数字。
- 表示自纪元以来的秒数的数字(参阅纪元秒)。
在内部,日期会被转换为 UTC(如果指定了时区),并存储为表示自纪元以来毫秒数的长整型数字。
如果需要纳秒精度,请使用 date_nanos 字段类型。
对日期的查询会在内部转换为对该长整型表示的范围查询,聚合和存储字段的结果会根据与字段关联的日期格式转换回字符串。
日期始终会被渲染为字符串,即使它们最初在 JSON 文档中是以长整型提供的。
日期格式可以自定义,但如果未指定 format,则使用默认格式:
"strict_date_optional_time||epoch_millis"
这意味着它将接受带有可选时间戳、且符合 strict_date_optional_time 支持格式的日期,或自纪元以来的毫秒数。
例如:
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 }
# 注意返回的 sort 值都是自纪元以来的毫秒数
GET my-index-000001/_search
{
"sort" : { "date" : "asc" }
}
date字段使用默认的format。- 该文档使用普通日期。
- 该文档包含时间。
- 该文档使用自纪元以来的毫秒数。
- 注意返回的
sort值都是自纪元以来的毫秒数。
日期将接受带小数点的数字,例如 {"date": 1618249875.123456},但在某些情况下(#70085)这些日期会丢失精度,因此应避免使用。
文本日期格式接受的文本字符串以及周日期的计算取决于 Elasticsearch 运行所在的 JDK 版本。更多信息参阅自定义日期格式。
多种日期格式
可以使用 || 作为分隔符指定多种格式。每种格式会依次尝试,直到找到匹配的格式为止。第一种格式将用于把自纪元以来的毫秒数转换回字符串。
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(可选,Boolean)是否应该将该字段以列式方式存储在磁盘上,以便之后可用于排序、聚合或脚本?接受true(默认)或false。format(可选,字符串)可解析的日期格式。默认为strict_date_optional_time||epoch_millis。locale(可选,字符串)解析日期时使用的本地化设置,因为并非所有语言中的月份名称和/或缩写都相同。默认为ENGLISH。ignore_malformed(可选,Boolean)如果为true,则忽略格式错误的数字。如果为false(默认),格式错误的数字会抛出异常并拒绝整个文档。注意,如果使用了script参数,则无法设置此项。index(可选,Boolean)该字段是否应该可以快速搜索?接受true(默认)和false。只启用doc_values的日期字段也可以查询,只是速度较慢。null_value(可选,字符串)接受配置的format之一格式的日期值,用于替换任何显式的null值。默认为null,表示该字段被视为缺失。注意,如果使用了script参数,则无法设置此项。on_script_error(可选,枚举)定义当script参数定义的脚本在索引时抛出错误时该怎么办。接受fail(默认),它会导致整个文档被拒绝;以及continue,它会将该字段记录到文档的_ignored元数据字段中并继续索引。只有同时设置了script字段时才能设置此参数。script(可选,字符串)如果设置了此参数,则该字段将索引由此脚本生成的值,而不是直接从源中读取值。如果输入文档中为该字段设置了值,文档将被拒绝并返回错误。脚本的格式与其运行时字段等效格式相同,并且应输出长整型时间戳。store(可选,Boolean)是否应该单独存储字段值,使其可以独立于_source字段检索。接受true或false(默认)。meta(可选,对象)关于该字段的元数据。
纪元秒
如果你需要以自纪元以来的秒数发送日期,请确保 format 中列出 epoch_second:
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" ]
}
}
]
}
}
合成 _source
合成 source 可能会对 date 字段的值进行排序。例如:
PUT idx
{
"settings": {
"index": {
"mapping": {
"source": {
"mode": "synthetic"
}
}
}
},
"mappings": {
"properties": {
"date": {
"type": "date"
}
}
}
}
PUT idx/_doc/1
{
"date": ["2015-01-01T12:10:30Z", "2014-01-01T12:10:30Z"]
}
将变为:
{
"date": ["2014-01-01T12:10:30.000Z", "2015-01-01T12:10:30.000Z"]
}