could not parse time time format must be in the form of hh mm - 如何解决此 Elasticsearch 异常 | Easysearch | 分布式搜索引擎

适用版本： 6.8-8.11

1. 错误异常的基本描述 #

could not parse time [value]. time format must be in the form of hh:mm 是 Elasticsearch 在解析时间字符串时抛出的异常。此错误表示时间字符串的整体形态不符合解析器要求的 hh:mm 格式。

此错误发生在 hour/minute 具体值校验之前，属于时间字符串结构错误。

常见现象 #

创建或更新 watch 时返回 HTTP 400 错误。
报错信息明确指出时间字符串不符合 hh:mm 格式。
常见于 daily、weekly、monthly 等 schedule 的 at 字段配置中。
如果时间字符串缺少冒号、有多个冒号或冒号在结尾，就会触发此错误。

典型报错与异常栈 #

{
  "error": {
    "root_cause": [
      {
        "type": "parse_exception",
        "reason": "could not parse time [1200]. time format must be in the form of hh:mm"
      }
    ],
    "type": "parse_exception",
    "reason": "could not parse time [1200]. time format must be in the form of hh:mm"
  },
  "status": 400
}

服务端日志中可能出现类似以下内容：

[2024-01-15T10:30:00,123][WARN ][o.e.x.w.t.s.DayTimes   ] [node-1] failed to parse time
ElasticsearchParseException[could not parse time [1200]. time format must be in the form of hh:mm]
    at org.elasticsearch.xpack.watcher.trigger.schedule.DayTimes.parse(DayTimes.java:123)
    at org.elasticsearch.xpack.watcher.trigger.schedule.DailySchedule.parse(DailySchedule.java:89)

2. 为什么会发生这个错误 #

Watcher 的时间解析器要求时间字符串必须是 hh:mm 格式（24小时制，用冒号分隔小时和分钟）。源码会先检查冒号位置：

没有冒号会报错：例如 1200、9（应该是 12:00、09:00）。
冒号在结尾也会报错：例如 12:、9:（缺少分钟部分）。
出现多个冒号同样会报错：例如 12:00:00、12:00:（应该是 12:00`）。

这说明异常发生在 hour/minute 具体值校验之前，时间字符串的基本结构就不正确。

常见原因包括：

缺少冒号：例如 1200 应该是 12:00。
冒号位置错误：例如 12:（冒号在结尾）、:12（冒号在开头）。
多个冒号：例如 12:00:00（包含秒数）、12::00（两个冒号）。
错误的时间分隔符：例如 12-00、12.00（应该用冒号而不是破折号或点号）。
模板渲染问题：使用 Mustache 或 script 模板时，渲染结果可能格式不正确（如 {{hour}}{{minute}} 缺少冒号）。
时区后缀：例如 12:00+08:00（包含时区，应该只是 12:00）。

3. 如何排查和解决这个异常和解决这个异常 #

排查步骤 #

查看原始时间字符串：从错误信息中提取时间值（could not parse time [value]）。
确认它是否恰好只有一个冒号，且冒号不在开头或结尾：

# 获取 watch 配置
GET _watcher/watch/<watch_id>?pretty

# 检查 trigger 部分的 schedule 中的 at 字段

排除不符合当前解析器预期的写法：

# 正确的时间格式示例
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "daily": {
        "at": ["12:00", "18:00"]  # 正确：hh:mm 格式
      }
    }
  },
  ...
}

合法的时间格式必须是：

恰好一个冒号：hh:mm
冒号不在开头或结尾：不能是 :mm 或 hh:
小时部分：00-23（两位数或一位数都可以，如 09:00 或 9:00）
分钟部分：00-59（两位数或一位数都可以，如 12:00 或 12:0）

检查模板渲染结果：如果使用动态模板，先渲染模板确认结果是否是合法的 hh:mm 格式。

排查时需要注意的问题 #

注意时间格式必须是 hh:mm，不能包含秒数（12:00:00 是错误的）。
不能包含时区后缀（12:00+08:00 是错误的）。
如果使用模板变量，确保变量渲染后不会产生缺少冒号的字符串。
检查是否有不可见字符（如制表符、换行符）混入时间字符串。

4. 如何解决这个错误 #

常用修复思路 #

改成标准 hh:mm 文本：

# 修复前（错误：缺少冒号）
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "daily": {
        "at": ["1200"]  # 错误：缺少冒号
      }
    }
  }
}

# 修复后（正确：标准 hh:mm 格式）
PUT _watcher/watch/<watch_id>
{
  "trigger": {
    "schedule": {
      "daily": {
        "at": ["12:00"]  # 正确
      }
    }
  }
}

不要直接传带秒数的时间：

# 错误：包含秒数
"at": ["12:00:00"]

# 正确：只包含小时和分钟
"at": ["12:00"]

在生成配置前用正则校验格式：

# 时间格式正则校验（简单示例）
# 正确的格式：^([01]?[0-9]|2[0-3]):([0-5]?[0-9])$
# 例如：12:00、09:30、23:59

后续注意事项与推荐建议 #

在编写时间配置时，始终使用 hh:mm 格式（如 12:00、09:30）。
对动态生成的时间字符串进行格式验证，确保符合 hh:mm 规范。
在测试环境验证 schedule 配置，特别是在使用模板或程序生成配置时。

借助 INFINI 产品提升排障效率 #

INFINI Console 提供可视化的 Watch 编辑和验证功能，可以在保存前检查时间格式的合法性，自动检测格式错误。
INFINI Gateway 可以记录 Watcher API 的完整请求内容，帮助捕获时间配置的详细错误上下文，并通过流量回放验证修复方案。
通过 INFINI Console 的 Watch 测试功能，可以在不执行完整 Watch 的情况下验证时间格式的合法性。

5. 小结 #

could not parse time [value]. time format must be in the form of hh:mm 是一个时间字符串结构错误，不是数值大小错误。解决此问题的关键是：让时间字符串整体长得像 hh:mm（恰好一个冒号，且在中间），解析器才会继续校验 hour/minute 的具体数值。

通过 INFINI Console 的配置验证功能和 INFINI Gateway 的请求捕获能力，可以更高效地定位和修复时间格式问题。

参考文档 #

附：日志上下文 #

下面保留当前页面中的源码或日志片段，便于继续结合异常调用栈定位问题：

int i = time.indexOf(":");
if (i < 0) {
    throw new ElasticsearchParseException("could not parse time [{}]. time format must be in the form of hh:mm", time);
}
if (i == time.length() - 1 || time.indexOf(":", i + 1) >= 0) {
    throw new ElasticsearchParseException("could not parse time [{}]. time format must be in the form of hh:mm", time);
}

标签

could not parse time time format must be in the form of hh mm - 如何解决此 Elasticsearch 异常