MongoDB中需用$dateToString按年月日或时分秒分组，但必须确保字段为Date类型，否则静默失败；推荐用$dateFromParts构造可排序的Date类型_id以避免字符串排序陷阱，并配合$match前置过滤和索引提升性能。
用 $dateToString 提取年月日或时分秒做分组
MongoDB 原生不支持像 SQL 的 DATE_TRUNC，得靠 $dateToString 把时间字段格式化成字符串再分组。关键点是：必须确保原始字段是 Date 类型，否则 $dateToString 会静默失败或返回空字符串。
按天统计示例（假设字段叫 createdAt）：
[
{
"$group": {
"_id": { "$dateToString": { "format": "%Y-%m-%d", "date": "$createdAt" } },
"count": { "$sum": 1 }
}
}
]
按小时则改成 "%Y-%m-%d %H"；注意 %H 是 24 小时制，别用 %I（12 小时制）导致午夜和中午混在一起。
- 如果时区重要，加
"timezone": "+08:00"参数，否则默认 UTC - 格式字符串里不能有空格以外的非法字符，比如
"%Y/%m/%d"没问题，但"%Y年%m月%d日"会报错 - 聚合前最好先用
$type确认$createdAt是"date"，不是字符串或数字
用 $dateFromParts + $group 构造时间键，避免字符串排序陷阱
用 $dateToString 分组后，_id 是字符串，按字典序排，比如 "2024-01-10" 会排在 "2024-01-2" 后面——这不对。真要排序或范围查询，得构造可比较的时间结构。
按天分组并保持可排序性：
[
{
"$group": {
"_id": {
"$dateFromParts": {
"year": { "$year": "$createdAt" },
"month": { "$month": "$createdAt" },
"day": { "$dayOfMonth": "$createdAt" }
}
},
"count": { "$sum": 1 }
}
}
]
这样 _id 是真正的 Date 类型（零点时刻），能直接用于 $sort 或后续 $match 范围过滤。
-
$dateFromParts在 MongoDB 3.6+ 才支持，旧版本只能退回到字符串 +$addFields拼 ISO 格式再转Date - 构造出的日期是 UTC 零点，若需本地时区零点，先用
$add加减毫秒偏移 - 这个方案比字符串快不了多少，但逻辑更健壮，尤其当你要接
$bucketAuto或画时间序列图时
遇到 errmsg: "can't convert from BSON type string to Date" 怎么办
这是最常踩的坑：集合里混了字符串格式的时间，比如 "2024-01-01T00:00:00Z"，$dateToString 无法自动转换，直接报错。
先查出问题数据：
db.collection.find({ "createdAt": { "$type": "string" } }).limit(5)
修复方式分两种：
- 批量转成真正
Date：db.collection.updateMany({ "createdAt": { "$type": "string" } }, [{ "$set": { "createdAt": { "$dateFromString": { "dateString": "$createdAt" } } } }]) - 聚合时兼容处理：
{ "$dateFromString": { "dateString": { "$cond": [{ "$eq": [{ "$type": "$createdAt" }, "string"] }, "$createdAt", null] } } }，再配合$ifNull防空 - 永远别依赖应用层写入时“保证类型正确”，加个
validationschema 更省心
性能差？检查索引是否覆盖 date 字段和排序需求
按小时/天聚合慢，往往不是聚合本身慢，而是没走索引导致全表扫描。MongoDB 的复合索引对 $group 效果有限，但对前置 $match 和最终 $sort 很关键。
比如只查最近 7 天的每小时统计，索引应建在 createdAt 上：
db.collection.createIndex({ "createdAt": 1 })
然后聚合里必须带 $match 过滤时间范围，且放在 $group 前面：
[
{ "$match": { "createdAt": { "$gte": ISODate("2024-01-01"), "$lt": ISODate("2024-01-08") } } },
{ "$group": { ... } }
]
- 别在
$group后才$match时间范围，那已经聚合完了，白算 - 如果经常按不同粒度查，考虑冗余一个
hourBucket字段（如"2024-01-01-14"），单独建索引，查得更快 - 千万级数据做小时聚合，即使有索引，也建议加
$limit控制输出量，防 OOM
Date 类型失守是常态。 
