$hour（获取小时）

最后更新：2026-10-09

$hour（获取小时）

$hour 返回日期中的小时部分（0 到 23），常用于按小时分析流量、监控告警窗口或生成小时维度报表。返回整数，采用 24 小时制。timezone 对小时的影响最大：UTC 时间加 8 小时才是北京时间，跨时区分析务必显式指定 timezone，否则数据会整体偏移。缺省为 UTC。需要两位小时字符串（如 09）时，可改用 $dateToString 的 %H 占位符。

📝 语法

{ $hour: { date: <日期表达式>, timezone: <时区> } }

⚙️ 参数

返回值：小时值（0-23）整数；date 为 null 时返回 null。

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $hour：按小时统计访问量（北京时间）
 db.visits.aggregate([
  { $group: {
      _id: { $hour: { date: '$visitAt', timezone: 'Asia/Shanghai' } },
      pv: { $sum: 1 }
  } }
])

运行结果：

{ "_id": 9, "pv": 2300 }
{ "_id": 10, "pv": 3100 }

📌 注意事项

• 24 小时制，范围 0 到 23
• 时区偏移会整体改变小时归属，例如 UTC+8 地区 8 点时 UTC 还是 0 点
• 分析「几点」这类业务语义时，一定要带 timezone

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们