Date 字段类型 #

在 Easysearch 中，日期可以表示为以下几种形式：

1. 一个长整型值，对应自纪元以来的毫秒数（必须为非负数）。日期在内部以此形式存储。
2. 一个格式化的字符串。
3. 一个整数值，对应自纪元以来的秒数（必须为非负数）。

要表示日期范围，可以使用 date range 字段类型。

代码样例 #

创建一个有两种日期格式的 date 字段

PUT testindex
{
  "mappings" : {
    "properties" :  {
      "release_date" : {
        "type" : "date",
        "format" : "strict_date_optional_time||epoch_millis"
      }
    }
  }
}

参数说明 #

下表列出了日期字段类型支持的参数，所有参数均为可选项。

格式 #

Easysearch 提供内置的日期格式，但您也可以自定义日期格式。

您可以指定多个日期格式，并使用 || 将它们分隔开。

内置格式 #

大多数日期格式都有一个以 strict_ 开头的对应格式。当格式以 strict_ 开头时，日期必须严格符合格式中指定的位数要求。例如，如果格式设置为 strict_year_month_day（"yyyy-MM-dd"），月份和日期必须是两位数字。因此，"2020-06-09" 是有效的，而 "2020-6-9" 是无效的。

Epoch 时间定义为 1970 年 1 月 1 日 00:00:00 UTC。

y：年份。
Y：基于周的年份。
M：月份。
w：年的序数周，从 01 到 53。
d：日期（天）。
D：年的序数日，从 001 到 365（闰年为 366）。
e：周的序数日，从 1（星期一）到 7（星期日）。
H：小时，从 0 到 23。
m：分钟。
s：秒。
S：秒的小数部分。
Z：时区偏移（例如，+0400；-0400；-04:00）。

数字化日期格式 #

基础日期格式 #

基本日期格式的各个组成部分之间没有分隔符。例如：“20190323”。

完整日期格式 #

完整日期格式的各个组成部分，日期部分使用 - 作为分隔符，时间部分使用 : 作为分隔符。 例如："2019-03-23T21:34"。

日期 #

时间 #

时区 #

完整时间 #

基于周的时间 #

定制格式 #

您可以为日期字段创建自定义格式。例如，以下请求将日期格式指定为常见的 "MM/dd/yyyy" 格式：

PUT testindex
{
  "mappings" : {
    "properties" :  {
      "release_date" : {
        "type" : "date",
        "format" : "MM/dd/yyyy"
      }
    }
  }
}

索引写入一个日期文档

PUT testindex/_doc/21
{
  "release_date" : "03/21/2019"
}

在搜索精确日期时，需要使用与指定格式相同的日期格式：

GET testindex/_search
{
  "query" : {
    "match": {
      "release_date" : {
        "query": "03/21/2019"
      }
    }
  }
}

范围查询默认使用字段的映射格式。您也可以通过提供 format 参数，以不同的格式指定日期范围：

GET testindex/_search
{
  "query": {
    "range": {
      "release_date": {
        "gte": "2019-01-01",
        "lte": "2019-12-31",
        "format": "yyyy-MM-dd"
      }
    }
  }
}

日期计算 #

日期字段类型支持使用日期数学运算来指定查询中的时间段。例如，在 范围查询中的 gt、gte、lt 和 lte 参数，以及 日期范围聚合中的 from 和 to 参数，都可以接受日期数学表达式。

日期数学表达式包含一个固定日期，后面可以选择性地跟随一个或多个数学运算表达式。固定日期可以是 now（自纪元以来的当前日期和时间，以毫秒为单位），或者以 || 结尾的字符串，用于指定日期（例如，2022-05-18||）。日期必须采用 默认格式（默认为 strict_date_time_no_millis||strict_date_optional_time||epoch_millis）。

如果字段映射中指定了多个日期格式，Easysearch 将使用第一个格式将纪元时间值（毫秒）转换为字符串。 如果字段映射未指定格式，Easysearch 将使用 strict_date_optional_time 格式将纪元时间值转换为字符串。

日期数学运算支持以下数学运算符

日期数学运算支持以下时间单位：

y：年 M：月 w：周 d：天 h 或 H：小时 m：分钟 s：秒

示例表达式 #

以下表达式展示了日期数学运算的用法：

now+1M：自纪元以来当前日期和时间的毫秒数加 1 个月。

2022-05-18||/M：将日期 2022-05-18 舍入到该月份的开始，解析为 2022-05-01。

2022-05-18T15:23||/h：将时间 15:23 于 2022-05-18 舍入到小时的开始，解析为 2022-05-18T15。

2022-05-18T15:23:17.789||+2M-1d/d：将时间 15:23:17.789 于 2022-05-18 加 2 个月减 1 天，然后舍入到当天的开始，解析为 2022-07-17。

在范围查询中使用日期运算 #

以下示例展示了在 范围查询中使用日期数学运算。

创建一个叫 release_date 的日期字段索引：

PUT testindex
{
  "mappings" : {
    "properties" :  {
      "release_date" : {
        "type" : "date"
      }
    }
  }
}

写入两个文档：

PUT testindex/_doc/1
{
  "release_date": "2022-09-14"
}
PUT testindex/_doc/2
{
  "release_date": "2022-11-15"
}

以下查询搜索 release_date 从 2022/09/14 的前 2 个月到后 1 天范围内的文档。最后的时间范围会被四舍五入到 2022/09/14 当天的开始时间：

GET testindex/_search
{
  "query": {
    "range": {
      "release_date": {
        "gte": "2022-09-14T15:23||/d",
        "lte": "2022-09-14||+2M+1d"
      }
    }
  }
}

返回内容包含两个文档：

{
  "took" : 1,
  "timed_out" : false,
  "_shards" : {
    "total" : 1,
    "successful" : 1,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 2,
      "relation" : "eq"
    },
    "max_score" : 1.0,
    "hits" : [
      {
        "_index" : "testindex",
        "_id" : "2",
        "_score" : 1.0,
        "_source" : {
          "release_date" : "2022-11-14"
        }
      },
      {
        "_index" : "testindex",
        "_id" : "1",
        "_score" : 1.0,
        "_source" : {
          "release_date" : "2022-09-14"
        }
      }
    ]
  }
}