$dayOfWeek（获取星期）
最后更新：2026-10-09
$dayOfWeek（获取星期）
$dayOfWeek 返回日期是星期几，以整数表示：1 为周日、7 为周六，与 JavaScript 的 Date.getDay() 一致。它常用于按星期分组统计流量或排班。注意它的编号从周日开始，与 ISO 标准的 $isoDayOfWeek（周一为 1）不同，选择时要确认语义。timezone 决定星期计算的基准，缺省为 UTC。
| 分类 | 日期 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $dayOfWeek: { date: <日期表达式>, timezone: <时区> } }⚙️ 参数
| date | 必填，日期表达式。 |
|---|---|
| timezone | 可选，计算依据的时区，缺省 UTC。 |
返回值：星期编号（1=周日，7=周六）整数；date 为 null 时返回 null。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $dayOfWeek：按星期统计访问量（北京时间）
db.logs.aggregate([
{ $group: {
_id: { $dayOfWeek: { date: '$ts', timezone: 'Asia/Shanghai' } },
cnt: { $sum: 1 }
} }
])运行结果：
{ "_id": 1, "cnt": 1240 }
{ "_id": 2, "cnt": 980 }📌 注意事项
- 1 是周日不是周一，容易踩坑；按周一到周日编号请用 $isoDayOfWeek
- 配合 $group 可做星期维度统计
- timezone 缺省为 UTC，中国业务建议显式传 Asia/Shanghai
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q1 代表星期几？
A1 是周日，7 是周六，与 JavaScript 的 getDay 一致。
Q想要周一到周日怎么编号？
A用 $isoDayOfWeek，它 1 为周一、7 为周日。
Q能直接得到星期几的中文名吗？
A不能，需配合 $switch 或 $dateToString 的 %A 转换。
