$minute（获取分钟）
最后更新：2026-10-09
$minute（获取分钟）
$minute 返回日期中的分钟部分（0 到 59），常用于按分钟粒度统计流量、监控指标或构造时间窗口标签。返回整数，不补零。timezone 会改变分钟归属：时区偏移带分钟的地区（如 UTC+5:45）换算后分钟数值不同，跨时区场景务必显式指定。配合 $hour、$second 可还原完整时间。若需两位字符串形式，可用 $dateToString 的 %M 占位符。
| 分类 | 日期 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $minute: { date: <日期表达式>, timezone: <时区> } }⚙️ 参数
| date | 必填，日期表达式。 |
|---|---|
| timezone | 可选，计算依据的时区，缺省 UTC。 |
返回值：分钟值（0-59）整数；date 为 null 时返回 null。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $minute：按小时-分钟统计日志量（北京时间）
db.logs.aggregate([
{ $group: {
_id: { h: { $hour: { date: '$ts', timezone: 'Asia/Shanghai' } }, m: { $minute: { date: '$ts', timezone: 'Asia/Shanghai' } } },
cnt: { $sum: 1 }
} }
])运行结果：
{ "_id": { "h": 8, "m": 30 }, "cnt": 56 }
{ "_id": { "h": 8, "m": 31 }, "cnt": 48 }📌 注意事项
- 范围 0 到 59，分钟以 60 进制回绕
- 时区偏移带分钟的地区（如 UTC+5:45）会导致分钟数值按当地换算
- 跨时区场景结果可能偏移，统计前统一 timezone
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q范围是多少？
A0 到 59。
Q时区会影响分钟吗？
A会，某些时区偏移带分钟（如 +5:45），导致分钟数值不同。
Q怎么输出两位分钟的字符串？
A用 $dateToString 的 %M 占位符输出两位字符串。
