Elasticsearch 条件字段为 date 类型时注意事项

毕小宝2025-12-26 10:13

背景

好一阵儿没有写 Elasticsearch 检索代码了，本周弄了一下，又回忆起一些坑点，记录一下。第一个就是 Elasticsearch 的字段类型，date 类型的字段设置查询条件时，参数值设置时，字符串和时间戳两种形式查询结果有差异，温故一下。

Elasticsearch 针对 date 类型字段设置查询条件

对一个索引中的 date 类型字段设置 RangeQuery 条件，查询 2025-12-21 至 22 日之间的数据，时间格式的字符串和时间戳之间的转化关系如下：

当传入时间戳时，查询结果总数为 8871：

当传入与条件字段 format 一致的时间字符串时，统计结果是8676：

问题分析

二者相差几十条，获取查询结果比对，发现传入时间戳时，结果中有不符合条件的数据。

根源是 Elasticsearch 存储 date 类型的值时，使用的 UTC 时间戳，而我们传入参数使用北京时间，直接查询数据晚了 8小时，调整时间戳范围 +8 小时后，两种统计结果就一致了：

结论：如果使用时间戳参数，必须注意时区，检索条件需要加8小时。

Java 解析特殊时间

解析一个不常见的时间字符串 Dec 24 14:07:35 2025，正确的解析方法如下，而且别想设置 Locale.ENGLISH 属性。

bash 复制代码

String dateString = "Dec 24 14:07:35 2025";
SimpleDateFormat sdf = new SimpleDateFormat("MMM dd HH:mm:ss yyyy", Locale.ENGLISH);
try {
    Date date = sdf.parse(dateString);
    System.out.println("解析后的日期: " + date);
} catch (ParseException e) {
    e.printStackTrace();
}