$ dateToString 只处理数组第一个元素，因它不支持数组输入，会静默取首项；需用 $map 遍历并配合 $toDate（如需）和 $dateToString 逐个格式化，且 timezone 应用前须确保原始时间为 UTC。
用 $dateToString 格式化数组里的日期字段，为什么只处理了第一个元素？
因为 $dateToString 本身不支持直接展开数组；它只接受单个日期值（Date 或 timestamp），如果输入是数组，MongoDB 会静默取第一个元素，不报错也不警告。
常见错误现象：$dateToString 在 $map 外直接作用于数组字段，结果输出全是同一天，或字段丢失。
- 必须先用
$map遍历数组，对每个元素单独调用$dateToString - 确保数组内每个元素确实是合法的
Date类型（不是字符串或毫秒数）；否则要先用$toDate转换 - 如果数组为空，
$map返回空数组，不会出错，但要注意下游逻辑是否能处理空值
$dateToString 的 timezone 参数在聚合中为何经常失效？
根本原因：MongoDB 服务器本地时区（system）和客户端期望时区不一致，而 timezone 参数只在表达式求值时起作用——但它不能改变原始时间戳的语义。
使用场景：你有一组 UTC 存储的 Date 字段（推荐做法），想按「北京时间」格式化显示。
-
timezone必须写成形如"Asia/Shanghai"的 IANA 时区名，不能写"+08:00"（MongoDB 5.0+ 才支持偏移量字符串，且兼容性差） - 如果原始字段已是本地时间（比如误存为东八区时间但没带时区信息），加
timezone反而会导致双重偏移，结果错 8 小时 - 验证方式：用
$dateToString同时输出timezone和iso字段对比，确认是否符合预期
数组 + 时区格式化的最小可行聚合管道怎么写？
核心就是三层嵌套：$map → $toDate（可选）→ $dateToString，缺一不可。
假设集合里有字段 events，类型为 [Date]，目标是转成「YYYY-MM-DD HH:mm」格式并按北京时间显示：
[
{
$addFields: {
"events_formatted": {
$map: {
input: "$events",
as: "dt",
in: {
$dateToString: {
format: "%Y-%m-%d %H:%M",
date: "$$dt",
timezone: "Asia/Shanghai"
}
}
}
}
}
}
]
- 如果
events是字符串数组（如["2024-01-01T12:00:00Z"]），in里得改成$dateToString: { date: { $toDate: "$$dt" }, ... } - 注意
$$dt是变量引用，不是字符串字面量；漏掉$$会报Path not found - 字段名不要用
date这类关键字做别名，容易和操作符冲突
为什么有时区处理后，分组或排序结果还是不对？
因为格式化后的字符串（如 "2024-01-01 08:00"）已丢失时间顺序信息，不能再用于时间比较或 $group 中的 $min/$max。
性能影响：字符串格式化是 CPU 密集型操作，尤其在大数组上；若后续还需按时间过滤，务必保留原始 Date 字段参与条件判断。
- 正确做法：先用原始
Date字段做筛选、排序、分组；最后一步才做时区格式化用于展示 - 避免在
$match阶段用格式化后的字符串反向查时间范围（比如events_formatted: { $gte: "2024-01-01" }），这既慢又不准 - 如果必须按格式化后的时间聚合，考虑在应用层处理，或用
$let+$switch做轻量级映射，而非全量格式化
时区不是“贴个标签就完事”的事情，它绑定在时间值的解释阶段；一旦转成字符串，原始时序语义就断了——这点最容易被忽略。
