$year（获取年份）

最后更新：2026-10-09

$year（获取年份）

$year 返回日期中的完整年份（如 2026），是最基础的日期提取表达式。常与 $month、$week 等组合成多级分组键，或用于按年归档、同比分析。返回整数。注意它与 $isoWeekYear 的区别：后者返回 ISO 周所属年份，跨年周场景下两者可能不同，按周统计时优先考虑 $isoWeekYear。

📝 语法

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

⚙️ 参数

返回值：年份整数；date 为 null 时返回 null。

▶ 示例

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

// $year：按年统计订单总额
 db.orders.aggregate([
  { $group: {
      _id: { $year: { date: '$orderDate' } },
      total: { $sum: '$amount' }
  } }
])

运行结果：

{ "_id": 2026, "total": 892000 }
{ "_id": 2025, "total": 764000 }

📌 注意事项

• 返回四位完整年份，不截断
• 按年分组时，date 为 null 的记录会被归入 null 桶
• 跨年周统计用 $isoWeekYear 而非 $year

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

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

关于我们