elasticsearch 之时间类型

「爱情、让人受尽委屈。」 2021-12-13 20:53 300阅读 0赞

### 日期类型（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"} 
    }

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

#### 多日期格式设置 ####

PUT my_index
    { 
      "mappings": { 
        "_doc": { 
          "properties": { 
            "date": { 
              "type":   "date",
              "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
            }
          }
        }
      }
    }

#### 设置参数 ####

*  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][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][https_www.elastic.co_guide_en_elasticsearch_reference_6.4_mapping-date-format.html]

[https_www.elastic.co_guide_en_elasticsearch_reference_6.4_date.html]: https://www.elastic.co/guide/en/elasticsearch/reference/6.4/date.html
[https_www.elastic.co_guide_en_elasticsearch_reference_6.4_mapping-date-format.html]: https://www.elastic.co/guide/en/elasticsearch/reference/6.4/mapping-date-format.html