如何将Elasticsearch聚合响应中的日期字段转换为指定时区？

问题背景 #

在Elasticsearch中查询聚合数据时，文档包含存储UTC时间的date类型字段timestampUtc。查询使用带时区偏移的参数（如2022-06-01T00:00:00+10:00），Elasticsearch会自动将参数转换为UTC时间与存储值比对，同时通过calendar_interval按天聚合。

当前查询语句：

{
  "query": {
    "bool": {
      "filter": {
        "bool": {
          "must": [
            {
              "range": {
                "timestampUtc": {
                  "gte": "2022-06-01T00:00:00+10:00",
                  "lte": "2022-07-05T23:59:59+10:00"
                }
              }
            }
          ]
        }
      }
    }
  },
  "aggs": {
    "value": {
      "date_histogram": {
        "field": "timestampUtc",
        "calendar_interval": "day"
      },
      "aggs": {
        "amount": {
          "sum": {
            "field": "amount.value"
          }
        }
      }
    }
  }
}

返回的聚合结果中，key_as_string字段为UTC格式（如2022-05-31T00:00:00.000Z），需要将其调整为与查询输入一致的时区格式。

解决方案 #

在date_histogram聚合配置中添加两个参数，即可指定输出日期的时区和格式：

• time_zone：设置目标时区，支持偏移量（如+10:00）或IANA时区名称（如Australia/Sydney）
• format：定义日期输出格式，与查询输入格式匹配，例如yyyy-MM-dd'T'HH:mm:ssXXX

修改后的聚合部分代码：

"aggs": {
  "value": {
    "date_histogram": {
      "field": "timestampUtc",
      "calendar_interval": "day",
      "time_zone": "+10:00",
      "format": "yyyy-MM-dd'T'HH:mm:ssXXX"
    },
    "aggs": {
      "amount": {
        "sum": {
          "field": "amount.value"
        }
      }
    }
  }
}

调整后，聚合结果的key_as_string将显示为2022-06-01T00:00:00+10:00这类与查询输入一致的格式。

注意事项 #

• 使用IANA时区名称（如Asia/Shanghai）时，Elasticsearch会自动处理夏令时切换，比固定偏移量更灵活
• format参数需与查询输入的日期格式严格匹配，确保输出格式完全一致

内容的提问来源于stack exchange，提问作者Joey Yi Zhao