$dateToParts（日期拆分为组成部分）

最后更新：2026-10-09

$dateToParts（日期拆分为组成部分）

$dateToParts 把一个日期拆成年、月、日、时、分、秒、毫秒等字段的文档，是 $dateFromParts 的逆操作。设 iso8601 为 true 时，改用 isoWeekYear、isoWeek、isoDayOfWeek 三个 ISO 周历字段。常用于按年、月分组统计（配合 $group 的 _id），或把日期展开成易读的普通文档供报表使用。timezone 决定拆分所依据的时区，缺省为 UTC，跨时区统计务必显式指定。

📝 语法

{ $dateToParts: { date: <日期表达式>, timezone: <时区>, iso8601: <布尔值> } }

⚙️ 参数

返回值：包含年/月/日/时/分/秒/毫秒（或 ISO 周历字段）的文档；date 为 null 时返回 null。

▶ 示例

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

// $dateToParts：把订单时间拆成部件（北京时间）
db.orders.aggregate([
  { $project: { parts: { $dateToParts: { date: '$createdAt', timezone: 'Asia/Shanghai' } } } }
])

运行结果：

{ "_id": 1, "parts": { "year": 2026, "month": 9, "day": 25, "hour": 8, "minute": 30, "second": 0, "millisecond": 0 } }

📌 注意事项

• 返回字段 key 固定为 year、month、day、hour、minute、second、millisecond
• iso8601 为 true 时字段变为 isoWeekYear、isoWeek、isoDayOfWeek
• timezone 缺省为 UTC，跨时区统计务必显式指定

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

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

关于我们