Elasticsearch日期格式解析报错求助：ISO 8601日期插入异常

你的日期值本身完全符合W3C规范，问题出在你给Elasticsearch配置的日期格式字符串上——Elasticsearch并不识别你写的TZD占位符，它遵循的是Java Time API（7.x及以上版本）或Joda-Time（旧版本）的日期格式符号规则。

为什么原来的格式会报错？ #

你写的YYYY-MM-DDThh:mm:ssTZD里，有几个不符合Elasticsearch格式规范的细节：

• YYYY：大写Y代表周年（Week Year），不是常规的日历年，应该用小写yyyy；
• DD：大写D代表年中的天数，不是月份内的日期，应该用小写dd；
• TZD：这是你自定义的时区偏移占位符，但Elasticsearch不认识它，需要用对应格式符号匹配+01:00这种带冒号的时区偏移。

正确的日期格式配置 #

针对你提供的2018-01-10T07:07:07+01:00格式，正确的Elasticsearch日期格式字符串应该是：

yyyy-MM-dd'T'HH:mm:ssXXX

各部分含义：

• yyyy：4位日历年
• MM：2位月份（01-12）
• dd：2位日期（01-31）
• 'T'：字面量的T，用单引号包裹避免被解析为格式符号
• HH：24小时制的小时（00-23），你的示例是24小时制的07，用HH更合适；如果是12小时制（带AM/PM）可以用hh
• mm：2位分钟（00-59）
• ss：2位秒数（00-59）
• XXX：带冒号的时区偏移（比如+01:00、-05:00），完美匹配你的日期值格式

示例映射配置 #

下面是完整的索引映射示例，将startDate字段配置为正确格式：

PUT /your-index-name
{
  "mappings": {
    "properties": {
      "startDate": {
        "type": "date",
        "format": "yyyy-MM-dd'T'HH:mm:ssXXX"
      }
    }
  }
}

验证插入 #

现在插入你提供的文档：

POST /your-index-name/_doc
{
  "startDate": "2018-01-10T07:07:07+01:00"
}

此时就不会再出现解析错误了。

额外提示 #

如果需要兼容多种日期格式，可以用竖线|分隔多个格式，比如：

"format": "yyyy-MM-dd'T'HH:mm:ssXXX|yyyy-MM-dd'T'HH:mm:ssZ|yyyy-MM-dd"

Elasticsearch会依次尝试用这些格式解析日期值。

内容的提问来源于stack exchange，提问作者covfefe