MongoDB如何算出两个日期之间的分钟差：使用$dateDiff算子

$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 分钟。