$datediff 返回分钟差为0的常见原因是输入字段非date类型；需用$type检查，字符串须经$datefromstring转换，且必须指定unit:"minute"，startdate早于enddate，支持时区偏移解析。
为什么 $dateDiff 返回的分钟差总是 0？
常见原因是输入字段不是 Date 类型，而是字符串或数字。MongoDB 的 $dateDiff 不会自动类型转换，遇到非 Date 值直接返回 null 或 0（取决于上下文），不会报错，极难排查。
实操建议：
- 先用
$type确认字段类型：{$expr: {$eq: [{$type: "$startAt"}, "date"]}} - 若为字符串，必须先用
$dateFromString转换，不能依赖隐式转换 - 注意时区：字符串解析默认按 UTC，若原始数据带本地时区偏移（如
"2024-05-20T14:30:00+08:00"），$dateFromString能正确识别；若无偏移，则需显式指定timezone参数
$dateDiff 计算分钟差的最小完整写法
必须显式指定 unit: "minute"，且两个日期字段都需是合法 Date 类型。以下是在聚合管道中计算 startAt 到 endAt 的分钟差：
{
$addFields: {
durationMinutes: {
$dateDiff: {
startDate: "$startAt",
endDate: "$endAt",
unit: "minute"
}
}
}
}
关键点：
-
startDate必须早于endDate，否则结果为负数（不是绝对值） - 不支持直接传入字符串，哪怕格式标准也不行
- 如果字段可能为空或缺失，加
$ifNull防止整个表达式失败：startDate: {$ifNull: ["$startAt", "$$NOW"]}
处理字符串日期时的三步安全转换
当数据存的是 "2024-05-20T09:15:22" 这类字符串，不能跳过转换直喂给 $dateDiff。
推荐写法（含容错）：
{
$addFields: {
startAtDate: {
$dateFromString: {
dateString: "$startAt",
onError: null,
onNull: null
}
},
endAtDate: {
$dateFromString: {
dateString: "$endAt",
onError: null,
onNull: null
}
}
}
},
{
$addFields: {
durationMinutes: {
$dateDiff: {
startDate: "$startAtDate",
endDate: "$endAtDate",
unit: "minute"
}
}
}
}
说明：
-
onError和onNull设为null可避免因单条数据异常导致整个聚合中断 - 转换失败后字段为
null，$dateDiff对null输入返回null，下游可用$ifNull统一兜底 - 不要用
$toDate替代$dateFromString—— 它对字符串支持有限，且不提供onError控制
性能与兼容性提醒
$dateDiff 是 MongoDB 5.0+ 引入的算子，4.x 及更早版本不可用。生产环境务必确认版本。
性能方面：
- 在
$match阶段无法直接使用$dateDiff做范围过滤（比如 “找大于 30 分钟的记录”），因为不能走索引；应先用$gte/$lte粗筛时间范围，再在$addFields中精算 - 大量文档做分钟级计算时，注意聚合内存限制（
allowDiskUse: true可能必要） - 如果只是判断“是否超过 N 分钟”，用毫秒差 + 整除更轻量：
{$divide: [{$subtract: ["$endAt", "$startAt"]}, 60000]}，但要注意结果是浮点数且不处理类型错误
真正容易被忽略的是：$dateDiff 的 unit: "minute" 是向下取整（floor），不是四舍五入。比如 90.9 秒 → 1 分钟，119.9 秒 → 1 分钟，120 秒才 → 2 分钟。
