$dateToString返回空或报错，因输入非BSON Date类型；须先用$type检查，再用$toDate转换字符串/数字，配合$cond或$ifNull防护，并显式指定format与timezone参数。
为什么 $dateToString 返回空或报错？
常见原因是输入字段不是合法的 Date 类型。MongoDB 不会自动把字符串（如 "2023-10-05"）转成日期，$dateToString 遇到非 Date 值直接返回 null 或抛出 TypeError。必须确保上游阶段输出的是 BSON Date —— 比如用 $toDate 显式转换。
实操建议：
- 先用
$type检查字段类型：{$type: "$created_at"}，确认返回"date" - 若源数据是字符串，加一步
$toDate：{$toDate: "$created_at"} - 避免对可能为
null的字段直接调用，可用$cond或$ifNull保护
$dateToString 必须指定 format 和 date 吗？
是的。date 是必填参数，表示要格式化的日期表达式；format 是可选但强烈建议显式指定 —— 不设时默认用 ISO 格式（"%Y-%m-%dT%H:%M:%S.%LZ"），但时区行为容易踩坑（默认 UTC）。不写 timezone 参数时，结果不含本地时区偏移，看起来像“少了 8 小时”。
实操建议：
- 始终写全
format和timezone，例如：{format: "%Y-%m-%d %H:%M", timezone: "+0800"} - 时区值必须是字符串，不能是数字或变量（
"+08:00"无效，要用"+0800"） - 想用系统本地时区？不行 —— MongoDB 没有
system时区关键字，只能硬编码或从应用层传入
在 $group 或 $project 中怎么安全使用？
$dateToString 只能用在表达式上下文中，比如 $project 的 value、$group 的 $sum 表达式内部，但不能直接作为 $group 的 _id 字段值（除非包裹在对象里）。更关键的是：它不能参与索引优化 —— 即使你按日期范围查，用 $dateToString 转出来的字符串字段也无法走日期索引。
实操建议：
- 聚合中做格式化仅用于最终输出，不要依赖它做查询或分组逻辑
- 需要按“年月”分组？用
$year+$month组合，比先转字符串再$substr更高效、可索引 - 如果必须字符串分组（如归档目录名），先在
$project提前算好，再在$group引用该字段，别重复调用
有哪些常见 format 占位符和易错点？
官方支持的占位符不多，且大小写敏感：%Y（4 位年）≠ %y（2 位年），%H（24 小时制）≠ %I（12 小时制）。最常被忽略的是毫秒 %L —— 它输出三位数字（000–999），不是 %3N 或其他写法。
实操建议：
- 常用组合优先记牢：
"%Y-%m-%d"、"%Y-%m-%dT%H:%M:%S"、"%Y%m%d_%H%M%S" - 不要用
%c或%x—— 这些 C 语言风格格式 MongoDB 不支持 - 中文星期/月份？不支持。所有 format 输出都是 ASCII 字符，需应用层补翻译
$toDate 和 $dateToString 往往得配对出现，少一个就全线崩。 
