格式
编辑format编辑
在 JSON 文档中，日期以字符串形式表示。Elasticsearch 使用一组预配置的格式来识别和解析这些字符串，并将它们转换为表示 UTC 时间戳（自纪元以来的毫秒数）的 long 值。
除了 内置格式 之外，还可以使用熟悉的 yyyy/MM/dd 语法指定您自己的 自定义格式
resp = client.indices.create(
index="my-index-000001",
body={
"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)
PUT my-index-000001
{
"mappings": {
"properties": {
"date": {
"type": "date",
"format": "yyyy-MM-dd"
}
}
}
}
许多支持日期值的 API 也支持 日期数学 表达式，例如 now-1m/d（当前时间减去一个月，向下舍入到最近的一天）。
自定义日期格式编辑
完全可自定义的日期格式受支持。这些格式的语法在 DateTimeFormatter 文档 中进行了说明。
内置格式编辑
以下大多数格式都有一个 strict 伴侣格式，这意味着月份的年份、月份和日期部分必须分别使用 4 位、2 位和 2 位数字，可能需要在前面添加零。例如，像 5/11/1 这样的日期将被视为无效，需要重写为 2005/11/01 才能被日期解析器接受。
要使用它们，您需要在日期格式名称前面添加 strict_，例如 strict_date_optional_time 而不是 date_optional_time。
当 日期字段被动态映射 时，这些严格的日期格式特别有用，以确保不会意外地将不相关的字符串映射为日期。
下表列出了所有支持的默认 ISO 格式
-
epoch_millis - 自纪元以来的毫秒数的格式化程序。请注意，此时间戳受 Java
Long.MIN_VALUE和Long.MAX_VALUE的限制。 -
epoch_second - 自纪元以来的秒数的格式化程序。请注意，此时间戳受 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 - 一个用于完整日期的基本格式化程序，使用四位周年份、两位周年份中的周数和一位星期几：
xxxx-'W'ww-e。 -
week_date_time或strict_week_date_time - 一个将完整周年份日期和时间组合在一起的格式化程序，它们之间用T分隔：
xxxx-'W'ww-e'T'HH:mm:ss.SSSZ。 -
week_date_time_no_millis或strict_week_date_time_no_millis - 一个将完整周年份日期和时间（不含毫秒）组合在一起的格式化程序，它们之间用T分隔：
xxxx-'W'ww-e'T'HH:mm:ssZ。 -
weekyear或strict_weekyear - 一个用于四位数周年份的格式化程序：
xxxx。 -
weekyear_week或strict_weekyear_week - 一个用于四位数周年份和两位数周的格式化程序：
xxxx-'W'ww。 -
weekyear_week_day或strict_weekyear_week_day - 一个用于四位数周年份、两位数周和一位数周日的格式化程序：
xxxx-'W'ww-e。 -
year或strict_year - 一个用于四位数年份的格式化程序：
yyyy。 -
year_month或strict_year_month - 一个用于四位数年份和两位数月份的格式化程序：
yyyy-MM。 -
year_month_day或strict_year_month_day - 一个用于四位数年份、两位数月份和两位数日期的格式化程序：
yyyy-MM-dd。