首页/数据/NoSQL 速查/date_histogram 时间直方图聚合
本包目录(322 条)
MongoDB99 条
Elasticsearch89 条
ClickHouse56 条时序与列式28 条选型与架构50 条

date_histogram 时间直方图聚合

date_histogram 按时间区间分桶统计,calendar_interval 按日历单位(day/month),fixed_interval 按固定时长(30m/7d);时区与空桶策略影响结果口径。

NoSQL 速查数据更新于 2026-10-12
日历间隔calendar_interval: minute/hour/day/week/month/quarter/year
固定间隔fixed_interval: 30s/5m/2h/7d(不能与日历单位混用)
常用参数time_zone、min_doc_count、extended_bounds、format

示例

示例
GET /logs/_search
{
  "size": 0,
  "aggs": {
    "per_day": {
      "date_histogram": {
        "field": "@timestamp",
        "calendar_interval": "day",
        "time_zone": "+08:00",
        "min_doc_count": 0,
        "extended_bounds": { "min": "now-7d/d", "max": "now/d" }
      }
    }
  }
}
结果 key 是毫秒时间戳、key_as_string 是按 format 与时区格式化后的字符串,展示层用后者更直观。

易错点

  • calendar_interval 与 fixed_interval 同时传会报错,二选一
  • 默认 min_doc_count 为 0 时中间空桶不返回,需要连续时间轴要显式设置或补 extended_bounds

数据来源与参考

  • Elasticsearch Guide: Date histogram aggregation
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌