$ dateToString 返回空字符串或报错是因为输入非 BSON Date 类型，须先用 $toDate 转换；format 仅支持有限 % 格式符（如 %Y、%m），不兼容 strftime 全集；处理缺失字段需用 $type + $cond 判断，不可依赖 $ifNull；时区默认 UTC，指定 timezone 需版本 ≥3.6 且系统支持 tzdata。
为什么 $dateToString 返回空字符串或报错？
常见原因是输入值不是合法的 Date 类型——比如传入了字符串、null、数字时间戳（毫秒）但没用 $toDate 转换。MongoDB 的 $dateToString 严格要求第一个参数 date 必须是 BSON Date，否则静默返回空字符串或抛出 invalid date 错误。
实操建议：
- 始终先用
$toDate做兜底转换，尤其当字段可能混存字符串日期（如"2024-03-15T08:22:10Z"）或时间戳时 - 在聚合管道中加
$type检查字段类型：{$type: "$createdAt"}，确认是"date" - 避免直接对
NumberLong(1710489730000)这类时间戳调用$dateToString，必须先$toDate
$dateToString 的 format 参数哪些写法有效？
格式符必须以 % 开头，且仅支持 MongoDB 官方文档列出的有限子集（不是 C 的 strftime 全集）。常见可用项有：%Y（4位年）、%m（月）、%d（日）、%H（24小时）、%M（分）、%S（秒）、%L（毫秒，三位）、%Z（时区缩写，如 UTC）。
容易踩的坑：
-
%I（12小时制）和%p（AM/PM）在部分 MongoDB 版本（如 5.0 之前）不支持，会忽略或报错 -
%z（RFC 2822 时区偏移，如+0800）从 4.0+ 才支持，旧版本要用%Z替代 - 中文环境别硬套
%c或%x—— MongoDB 不识别这些 locale 相关格式符 - 格式字符串里非
%开头的字符原样保留，比如"%Y-%m-%d %H:%M"输出"2024-03-15 08:22"
如何安全地处理缺失日期字段并默认显示“N/A”？
不能直接在 $dateToString 外层套 $ifNull，因为 $dateToString 对 null 输入返回空字符串而非 null，导致 $ifNull 无法捕获。正确做法是先判断字段是否存在/有效，再决定是否格式化。
推荐写法（聚合阶段）：
{
$addFields: {
formattedDate: {
$cond: {
if: { $and: [{ $ne: ["$createdAt", null] }, { $eq: [{ $type: "$createdAt" }, "date"] }] },
then: { $dateToString: { format: "%Y-%m-%d", date: "$createdAt" } },
else: "N/A"
}
}
}
}
关键点：
- 用
$type显式检查类型比单纯$ne: [null]更可靠（排除字符串"null"等边界） - 不要依赖
$dateToString自身的容错——它对非法输入不报错也不抛异常，只是沉默失败 - 如果字段是字符串但格式统一（如 ISO 8601），可改用
$concat+$substr截取，比强转更轻量
在 Node.js 驱动里调用 $dateToString 为什么时区总是 UTC？
MongoDB 服务端存储的 Date 始终是 UTC，$dateToString 默认按服务器本地时区渲染（通常就是 UTC）。想转成客户端所在时区（如东八区），不能靠 $dateToString 的 timezone 参数硬设——它只接受 IANA 时区名（如 "Asia/Shanghai"）且要求 mongod 启动时已加载对应 tzdata。
更可控的做法：
- 服务端聚合中显式指定
timezone: "Asia/Shanghai"，但需确认 MongoDB 版本 ≥ 3.6 且系统已安装 tzdata - Node.js 层用
moment-timezone或Intl.DateTimeFormat在应用侧格式化，把原始 ISO 字符串（$dateToString输出）再转一次 - 避免在聚合里做复杂时区计算——比如夏令时切换日，
$dateToString不会自动适配，容易出错
时区逻辑越靠近业务代码，越容易测试和调试；塞进聚合管道里，问题往往暴露在生产环境才浮现。
