$dateDiff不能在find()中直接使用，因为它属于聚合表达式而非查询操作符，必须置于$project、$addFields等聚合管道阶段内；若需在find()中使用，须配合$expr，且字段必须为合法Date类型，字符串需先用$dateFromString转换。
$dateDiff 是 MongoDB 5.0+ 引入的聚合阶段操作符，但它**不能直接在 shell 或普通查询中使用**——必须出现在 $project、$addFields、$set 等聚合管道阶段里。如果你在 find() 中直接写 $dateDiff，会报错 unknown operator: $dateDiff。
为什么 $dateDiff 在 find() 里不生效？
MongoDB 的 find() 方法只支持查询表达式（如 $gt、$eq），不支持聚合表达式。而 $dateDiff 属于聚合表达式，只能用在聚合管道中。
- 错误写法：
db.orders.find({ "diff": { "$dateDiff": { "startDate": "$createdAt", "endDate": "$updatedAt", "unit": "hour" } } })→ 报错 - 正确位置：必须包裹在
$project或$addFields里，作为聚合的一部分 - 替代方案：如果只是简单筛选，用
$expr+$dateDiff可以在find()的查询条件中用，但仍有严格语法限制
怎么在聚合中正确使用 $dateDiff？
最常用场景是计算两个日期字段之间相差多少天/小时/分钟。注意：两个日期字段都必须是合法的 Date 类型（不是字符串）。
- 单位必须是字符串，且仅支持：
"year"、"quarter"、"month"、"week"、"day"、"hour"、"minute"、"second"、"millisecond" -
startDate和endDate都要指定，且顺序不能反——结果是endDate - startDate（正数表示 endDate 更晚） - 示例（计算订单创建到更新间隔的小时数）：
db.orders.aggregate([ { "$addFields": { "hoursSinceCreated": { "$dateDiff": { "startDate": "$createdAt", "endDate": "$updatedAt", "unit": "hour" } } } } ])
$dateDiff 遇到字符串日期会怎样？
如果 startDate 或 endDate 是字符串（如 "2023-01-01T00:00:00Z"），MongoDB 不会自动转换，而是直接返回 null，且不会报错——这极易导致静默失败。
- 验证类型：先用
$type检查字段是否为"date"，例如：{"$type": "$createdAt"}返回"date"才安全 - 转换字符串：若数据存的是字符串，需先用
$dateFromString转换，再传给$dateDiff - 常见坑：
"2023-01-01"这种格式缺少时间部分，在$dateFromString中必须显式指定onNull或onError处理逻辑，否则出错
性能和兼容性要注意什么？
$dateDiff 本身计算开销极小，但它的前置依赖（比如字段类型校验、字符串解析）可能拖慢聚合速度，尤其在大集合上。
- 版本限制：仅 MongoDB 5.0 及以上支持；4.x 及更早版本完全不可用，强行使用会触发解析错误
- 索引无效：
$dateDiff的结果无法被索引加速，所以别指望靠它优化查询性能 - 时区注意：所有计算基于 UTC，如果字段含本地时区信息（如带
+0800），需确保入库前已标准化，否则差值不准
真正容易被忽略的是字段类型——哪怕只有一条文档的 createdAt 是字符串，整个聚合里那条记录的 $dateDiff 结果就是 null，而且没提示。上线前最好用 $type 扫一遍关键字段。
