$dayOfYear（获取年内第几天）
最后更新：2026-10-09
$dayOfYear（获取年内第几天）
$dayOfYear 返回日期是一年中的第几天（1 到 366），常用于年度进度统计、季节性分析或计算剩余天数。返回值从 1 开始，平年最大 365、闰年最大 366。它按 UTC 或指定 timezone 计算，跨时区场景下日期边界会偏移，应显式传 timezone。也可配合 $dateToString 的 %j 输出带前导零的三位字符串。
| 分类 | 日期 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $dayOfYear: { date: <日期表达式>, timezone: <时区> } }⚙️ 参数
| date | 必填，日期表达式。 |
|---|---|
| timezone | 可选，计算依据的时区，缺省 UTC。 |
返回值：年内第几天（1-366）整数；date 为 null 时返回 null。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $dayOfYear：取事件年内第几天
db.events.aggregate([
{ $project: {
doy: { $dayOfYear: '$eventDate' },
label: { $dateToString: { format: '%j', date: '$eventDate' } }
} }
])运行结果：
{ "_id": 1, "doy": 268, "label": "268" }
{ "_id": 2, "doy": 1, "label": "001" }📌 注意事项
- 1 月 1 日返回 1，12 月 31 日平年返回 365、闰年返回 366
- 需要带前导零的三位字符串用 %j 格式化
- 与 $week 的边界都以 UTC/指定时区为准，统计前先统一时区
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q一年最多返回多少？
A平年 365、闰年 366。
Q和 $dayOfMonth 有什么区别？
A$dayOfMonth 返回月内第几天，$dayOfYear 返回年内第几天。
Q结果需要三位字符串怎么处理？
A用 $dateToString 的 %j 占位符，自动补前导零。
