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"
}
}
}
}
许多支持日期值的 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。