New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« enabled ignore_above »
Elastic 文档 ›Elasticsearch 指南 [8.17] ›映射 ›映射参数

format

编辑

format

编辑

在 JSON 文档中，日期表示为字符串。Elasticsearch 使用一组预配置的格式来识别这些字符串并将其解析为表示 UTC 时间中自 epoch 以来的毫秒数的长整型值。

除了内置格式之外，还可以使用熟悉的 yyyy/MM/dd 语法指定您自己的自定义格式。

resp = client.indices.create(
    index="my-index-000001",
    mappings={
        "properties": {
            "date": {
                "type": "date",
                "format": "yyyy-MM-dd"
            }
        }
    },
)
print(resp)
response = client.indices.create(
  index: 'my-index-000001',
  body: {
    mappings: {
      properties: {
        date: {
          type: 'date',
          format: 'yyyy-MM-dd'
        }
      }
    }
  }
)
puts response
res, err := es.Indices.Create(
	"my-index-000001",
	es.Indices.Create.WithBody(strings.NewReader(`{
	  "mappings": {
	    "properties": {
	      "date": {
	        "type": "date",
	        "format": "yyyy-MM-dd"
	      }
	    }
	  }
	}`)),
)
fmt.Println(res, err)
const response = await client.indices.create({
  index: "my-index-000001",
  mappings: {
    properties: {
      date: {
        type: "date",
        format: "yyyy-MM-dd",
      },
    },
  },
});
console.log(response);
PUT my-index-000001
{
  "mappings": {
    "properties": {
      "date": {
        "type":   "date",
        "format": "yyyy-MM-dd"
      }
    }
  }
}
Copy as curlTry in Elastic 

许多支持日期值的 API 也支持日期数学表达式，例如 now-1m/d — 当前时间减去一个月，并向下舍入到最近的一天。

自定义日期格式

编辑

支持完全自定义的日期格式。这些格式的语法在DateTimeFormatter 文档中进行了解释。

JDK 版本之间区域信息差异

编辑

JDK 版本和不同的区域设置之间，日期格式可能会存在一些差异。特别是，文本日期格式使用的文本字符串可能存在差异，并且星期日期计算的结果也可能存在差异。

以下字段说明符使用的文本字符串可能存在差异

  • 任意长度的 B、E、G、O、a、v、z
  • 长度为 3 或更大的 L、M、Q、q、c、e
  • 长度为 4 的 Z

如果文本格式在 Elasticsearch 或 JDK 版本之间发生更改，则可能会导致摄取、输出和重新索引出现重大问题。建议在自定义日期格式中始终使用数值字段，这些字段不受区域信息的影响。

使用 Y、W 和 w 字段说明符的星期日期计算也可能存在差异。用于计算星期日期的基础数据可能会因 JDK 版本和区域设置而异；这可能会导致同一日历日期的计算星期日期存在差异。建议使用内置的星期日期格式，它将始终使用 ISO 规则来计算星期日期。

特别是，JDK 22 和 23 版本之间的区域信息发生了重大变化。在 JDK 22 及更早版本上运行时，Elasticsearch 将使用 COMPAT 区域数据库，而在 JDK 23 及更高版本上运行时，将使用 CLDR 区域数据库。此更改可能会导致 Elasticsearch 接受的文本日期格式以及计算的星期日期出现重大差异。如果您正在使用受影响的说明符，则可能需要修改您的摄取或输出集成代码，以考虑这两个 JDK 版本之间的差异。

内置格式

编辑

以下大多数格式都有一个 strict 伴随格式，这意味着月份的年、月和日部分必须分别使用 4、2 和 2 位数字，可能需要前导零。例如，像 5/11/1 这样的日期将被视为无效，并且需要重写为 2005/11/01 才能被日期解析器接受。

要使用它们，您需要将 strict_ 前缀添加到日期格式的名称，例如使用 strict_date_optional_time 而不是 date_optional_time。

当动态映射日期字段时，这些严格的日期格式特别有用，以确保不会意外地将不相关的字符串映射为日期。

下表列出了所有支持的默认 ISO 格式

epoch_millis
自 epoch 以来的毫秒数格式化程序。请注意，此时间戳受 Java Long.MIN_VALUE 和 Long.MAX_VALUE 的限制。
epoch_second
自 epoch 以来的秒数格式化程序。请注意，此时间戳受 Java Long.MIN_VALUE 和 Long. MAX_VALUE 除以 1000 (一秒内的毫秒数) 的限制。
date_optional_time 或 strict_date_optional_time

通用的 ISO 日期时间解析器，其中日期必须至少包含年份，并且时间（用 T 分隔）是可选的。示例：yyyy-MM-dd'T'HH:mm:ss.SSSZ 或 yyyy-MM-dd。

NOTE: When using `date_optional_time`, the parsing is lenient and will attempt to parse
numbers as a year (e.g. `292278994` will be parsed as a year). This can lead to unexpected results
when paired with a numeric focused format like `epoch_second` and `epoch_millis`.
It is recommended you use `strict_date_optional_time` when pairing with a numeric focused format.
strict_date_optional_time_nanos
通用的 ISO 日期时间解析器，其中日期必须至少包含年份，并且时间（用 T 分隔）是可选的。秒的小数部分具有纳秒分辨率。示例：yyyy-MM-dd'T'HH:mm:ss.SSSSSSZ 或 yyyy-MM-dd。
basic_date
基本格式化程序，用于表示完整的日期，格式为四位数的年份、两位数的月份和两位数的日期：yyyyMMdd。
basic_date_time
将基本日期和时间组合在一起的基本格式化程序，用 T 分隔：yyyyMMdd'T'HHmmss.SSSZ。
basic_date_time_no_millis
将基本日期和时间组合在一起的基本格式化程序，没有毫秒，用 T 分隔：yyyyMMdd'T'HHmmssZ。
basic_ordinal_date
用于表示完整序数日期的格式化程序，使用四位数的年份和三位数的年积日：yyyyDDD。
basic_ordinal_date_time
用于表示完整序数日期和时间的格式化程序，使用四位数的年份和三位数的年积日：yyyyDDD'T'HHmmss.SSSZ。
basic_ordinal_date_time_no_millis
用于表示完整序数日期和时间的格式化程序，没有毫秒，使用四位数的年份和三位数的年积日：yyyyDDD'T'HHmmssZ。
basic_time
基本格式化程序，用于表示两位数的小时、两位数的分钟、两位数的秒、三位数的毫秒和时区偏移：HHmmss.SSSZ。
basic_time_no_millis
基本格式化程序，用于表示两位数的小时、两位数的分钟、两位数的秒和时区偏移：HHmmssZ。
basic_t_time
基本格式化程序，用于表示两位数的小时、两位数的分钟、两位数的秒、三位数的毫秒，并以 T 为前缀的时区偏移：'T'HHmmss.SSSZ。
basic_t_time_no_millis
基本格式化程序，用于表示两位数的小时、两位数的分钟、两位数的秒，并以 T 为前缀的时区偏移：'T'HHmmssZ。
basic_week_date 或 strict_basic_week_date
基本格式化程序，用于表示完整的日期，格式为四位数周数年份、两位数周数和一位数星期几：xxxx'W'wwe。
basic_week_date_time 或 strict_basic_week_date_time
将基本周数年份日期和时间组合在一起的基本格式化程序，用 T 分隔：xxxx'W'wwe'T'HHmmss.SSSZ。
basic_week_date_time_no_millis 或 strict_basic_week_date_time_no_millis
将基本周数年份日期和时间组合在一起的基本格式化程序，没有毫秒，用 T 分隔：xxxx'W'wwe'T'HHmmssZ。
date 或 strict_date
用于表示完整的日期的格式化程序，格式为四位数的年份、两位数的月份和两位数的日期：yyyy-MM-dd。
date_hour 或 strict_date_hour
将完整日期和两位数的小时组合在一起的格式化程序：yyyy-MM-dd'T'HH。
date_hour_minute 或 strict_date_hour_minute
将完整日期、两位数的小时和两位数的分钟组合在一起的格式化程序：yyyy-MM-dd'T'HH:mm。
date_hour_minute_second 或 strict_date_hour_minute_second
将完整日期、两位数的小时、两位数的分钟和两位数的秒组合在一起的格式化程序：yyyy-MM-dd'T'HH:mm:ss。
date_hour_minute_second_fraction 或 strict_date_hour_minute_second_fraction
将完整日期、两位数的小时、两位数的分钟、两位数的秒和三位数的秒的小数部分组合在一起的格式化程序：yyyy-MM-dd'T'HH:mm:ss.SSS。
date_hour_minute_second_millis 或 strict_date_hour_minute_second_millis
将完整日期、两位数的小时、两位数的分钟、两位数的秒和三位数的秒的小数部分组合在一起的格式化程序：yyyy-MM-dd'T'HH:mm:ss.SSS。
date_time 或 strict_date_time
将完整日期和时间组合在一起的格式化程序，用 T 分隔：yyyy-MM-dd'T'HH:mm:ss.SSSZ。
date_time_no_millis 或 strict_date_time_no_millis
将完整日期和时间组合在一起的格式化程序，没有毫秒，用 T 分隔：yyyy-MM-dd'T'HH:mm:ssZ。
hour 或 strict_hour
用于表示两位数的小时的格式化程序：HH
hour_minute 或 strict_hour_minute
用于表示两位数的小时和两位数的分钟的格式化程序：HH:mm。
hour_minute_second 或 strict_hour_minute_second
用于表示两位数的小时、两位数的分钟和两位数的秒的格式化程序：HH:mm:ss。
hour_minute_second_fraction 或 strict_hour_minute_second_fraction
用于表示两位数的小时、两位数的分钟、两位数的秒和三位数的秒的小数部分的格式化程序：HH:mm:ss.SSS。
hour_minute_second_millis 或 strict_hour_minute_second_millis
用于表示两位数的小时、两位数的分钟、两位数的秒和三位数的秒的小数部分的格式化程序：HH:mm:ss.SSS。
ordinal_date 或 strict_ordinal_date
用于表示完整序数日期的格式化程序，使用四位数的年份和三位数的年积日：yyyy-DDD。
ordinal_date_time 或 strict_ordinal_date_time
用于表示完整序数日期和时间的格式化程序，使用四位数的年份和三位数的年积日：yyyy-DDD'T'HH:mm:ss.SSSZ。
ordinal_date_time_no_millis 或 strict_ordinal_date_time_no_millis
用于表示完整序数日期和时间的格式化程序，没有毫秒，使用四位数的年份和三位数的年积日：yyyy-DDD'T'HH:mm:ssZ。
time 或 strict_time
用于表示两位数的小时、两位数的分钟、两位数的秒、三位数的秒的小数部分和时区偏移的格式化程序：HH:mm:ss.SSSZ。
time_no_millis 或 strict_time_no_millis
用于表示两位数的小时、两位数的分钟、两位数的秒和时区偏移的格式化程序：HH:mm:ssZ。
t_time 或 strict_t_time
一个格式化器，用于表示两位数的小时（一天中的小时），两位数的分钟（小时中的分钟），两位数的秒（分钟中的秒），三位数的秒的小数部分，以及以 T 开头的时间偏移量：'T'HH:mm:ss.SSSZ。
t_time_no_millis 或 strict_t_time_no_millis
一个格式化器，用于表示两位数的小时（一天中的小时），两位数的分钟（小时中的分钟），两位数的秒（分钟中的秒），以及以 T 开头的时间偏移量：'T'HH:mm:ssZ。
week_date 或 strict_week_date
一个格式化器，用于表示完整的日期，格式为四位数的年份（按周计算），两位数的周（一年中的周），以及一位数的一周中的第几天：YYYY-'W'ww-e。这使用 ISO 周日期定义。
week_date_time 或 strict_week_date_time
一个格式化器，用于组合完整的按周计算的年份日期和时间，并用 T 分隔：YYYY-'W'ww-e'T'HH:mm:ss.SSSZ。这使用 ISO 周日期定义。
week_date_time_no_millis 或 strict_week_date_time_no_millis
一个格式化器，用于组合完整的按周计算的年份日期和时间（不带毫秒），并用 T 分隔：YYYY-'W'ww-e'T'HH:mm:ssZ。这使用 ISO 周日期定义。
weekyear 或 strict_weekyear
一个格式化器，用于表示四位数的按周计算的年份：YYYY。这使用 ISO 周日期定义。
weekyear_week 或 strict_weekyear_week
一个格式化器，用于表示四位数的按周计算的年份和两位数的一年中的周：YYYY-'W'ww。这使用 ISO 周日期定义。
weekyear_week_day 或 strict_weekyear_week_day
一个格式化器，用于表示四位数的按周计算的年份，两位数的一年中的周，以及一位数的一周中的第几天：YYYY-'W'ww-e。这使用 ISO 周日期定义。
year 或 strict_year
一个格式化器，用于表示四位数的年份：yyyy。
year_month 或 strict_year_month
一个格式化器，用于表示四位数的年份和两位数的一年中的月份：yyyy-MM。
year_month_day 或 strict_year_month_day
一个格式化器，用于表示四位数的年份，两位数的一年中的月份和两位数的一月中的日期：yyyy-MM-dd。
« enabled ignore_above »

On this page

Was this helpful?
Feedback