$isoDayOfWeek（ISO 星期）

最后更新：2026-10-09

$isoDayOfWeek（ISO 星期）

$isoDayOfWeek 按 ISO 8601 标准返回星期编号：1 为周一、7 为周日，与 $dayOfWeek（周日为 1）语义不同。它适合与 $isoWeek、$isoWeekYear 组合做周维度统计，保证「每周」边界符合国际惯例。返回值为整数，timezone 决定星期计算的基准，缺省为 UTC，中国业务建议显式传 Asia/Shanghai。

📝 语法

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

⚙️ 参数

返回值：ISO 星期编号（1=周一，7=周日）整数；date 为 null 时返回 null。

▶ 示例

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

// $isoDayOfWeek：按 ISO 星期统计销售额（北京时间）
 db.sales.aggregate([
  { $group: {
      _id: { $isoDayOfWeek: { date: '$soldAt', timezone: 'Asia/Shanghai' } },
      total: { $sum: '$amount' }
  } }
])

运行结果：

{ "_id": 1, "total": 3200 }
{ "_id": 2, "total": 2750 }

📌 注意事项

• 与 $dayOfWeek 差一个偏移：周一在 $dayOfWeek 中是 2，在 $isoDayOfWeek 中是 1
• 常与 $isoWeek、$isoWeekYear 组合做 ISO 周统计
• timezone 缺省为 UTC，统计前先统一时区

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

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

关于我们