ElasticSearch数据类型Date介绍

2022-07-12 14:24:07 浏览数 (1)

本文主要简单介绍ES中的数据类型Date相关概念，希望对大家学习和理解ES有所帮助。

JSON并没有提供一种date数据类型，所以在elasticsearch中的date类型可以是下面的形式：

  • 格式化好的字符串，比如"2015-01-01"，"2015/01/01 12:10:30"
  • 一个long类型整数，代表从纪元以来的毫秒数
  • 一个integer类型整数，表示从纪元开始的秒数

注意：

  • long和integer必须是非负数
  • 使用带格式的日期表示1970年之前的日期

在内部，日期会转换为UTC（如果指定了时区），并存储为一个整数，表示自纪元以来的毫秒数。

日期查询会在内部转换为这种长表示形式的范围查询，并且聚合和存储字段的结果将转换为字符串，具体取决于与该字段关联的日期格式。

日期将始终以字符串形式呈现，即使最初在JSON文档中提供的日期很长也是如此。

日期格式可以自定义，但如果未指定格式，则使用默认格式：

代码语言：javascript复制
"strict_date_optional_time||epoch_millis"

这意味着它将接受带有可选时间戳记的日期，该时间戳记与strict_date_optional_time或毫秒（自纪元）支持的格式一致。

代码语言：javascript复制
curl -X PUT "localhost:9200/my-index-000001?pretty" -H 'Content-Type: application/json' -d'
{
  "mappings": {
    "properties": {
      "date": {
        // 使用默认的date. format格式
        "type": "date" 
      }
    }
  }
}
'
代码语言：javascript复制
curl -X PUT "localhost:9200/my-index-000001/_doc/1?pretty" -H 'Content-Type: application/json' -d'
// 使用一个简单的日期格式
{ "date": "2015-01-01" }
'
代码语言：javascript复制
curl -X PUT "localhost:9200/my-index-000001/_doc/2?pretty" -H 'Content-Type: application/json' -d'
// 带有时间的格式
{ "date": "2015-01-01T12:10:30Z" }
'
代码语言：javascript复制
curl -X PUT "localhost:9200/my-index-000001/_doc/3?pretty" -H 'Content-Type: application/json' -d'
// 自纪元以来的毫秒数。
{ "date": 1420070400001 }
'
代码语言：javascript复制
curl -X GET "localhost:9200/my-index-000001/_search?pretty" -H 'Content-Type: application/json' -d'
{
  //请注意，返回的排序值都自毫秒起（以毫秒为单位）。
  "sort": { "date": "asc"} 
}
'

多种日期格式

可以使用||分隔指定多种格式作为分隔符。依次尝试每种格式，直到找到匹配的格式。第一种格式将用于将毫秒数（从纪元开始）转换回字符串。

代码语言：javascript复制
curl -X PUT "localhost:9200/my-index-000001?pretty" -H 'Content-Type: application/json' -d'
{
  "mappings": {
    "properties": {
      "date": {
        "type":   "date",
        "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
      }
    }
  }
}
'
Date Field的参数列表
  • boost
    • 映射字段级查询时间的增加。接受浮点数，默认为1.0
  • doc_values
    • 该字段是否应该以跨步的方式存储在磁盘上，以便以后可以用于排序，聚合或编写脚本？接受true（默认）或false
  • format
    • 日期可以被解析。默认为strict_date_optional_time||epoch_millis
  • locale
    • 自几个月以来，解析日期时使用的语言环境在所有语言中的名称和/或缩写都不相同。默认值为ROOT语言环境
  • ignore_malformed
    • 如果为true，则忽略格式错误的数字。如果为false（默认），则格式错误的数字将引发异常并拒绝整个文档
  • index
    • 该field是否应该被索引搜索，接受的值为true或者false
  • null_value
    • 可以接受该field为null值，接受的参数为true或者false
  • store
    • 是否应与_source字段分开存储和检索字段值。接受的值为true或者false
  • meta
    • 有关该字段的元数据
编程算法 json es unix

0 人点赞