$hour仅支持date类型字段，字符串需先用$datefromstring转换，毫秒时间戳可用$todate；$dayofweek周日为1，转iso风格需手动偏移；应复用解析结果避免重复开销，且仅限$project等表达式阶段使用。
提取日期字段的小时值：用 $hour 处理 ISODate 或时间戳
在 MongoDB 聚合管道中，$hour 只能作用于 Date 类型字段（即 ISODate），不能直接处理字符串或数字时间戳。如果字段是字符串（如 "2024-05-20T14:30:00Z"），必须先用 $dateFromString 转成日期对象，否则会返回 null。
常见错误现象：$hour 对非 Date 字段返回 null，且不报错，容易误判为数据为空。
- 确保源字段类型是
Date：可用{$type: "$field"}检查，返回"date"才安全 - 若字段是毫秒时间戳（number），需先转成日期：
{$dateFromParts: {millisecond: "$ts_field"}}或{$toDate: "$ts_field"}（MongoDB 4.0+） - 时区注意：
$hour默认按 UTC 解析；如需本地时区小时，得配合$dateToString+timezone参数预处理
{$project: {hour_of_event: {$hour: "$created_at"}}}
提取星期几：$dayOfWeek 返回 1（周日）到 7（周六）
$dayOfWeek 的返回值是整数，且以**周日为第 1 天**——这点和很多前端库（如 JavaScript 的 getDay()）一致，但和 ISO 8601（周一为 1）冲突。如果业务要求“周一=1”，不能直接用 $dayOfWeek，得手动偏移。
使用场景：统计工作日订单量、过滤周末日志、按周几分组报表。
- 直接使用：
{$dayOfWeek: "$order_time"}→ 周日=1，周六=7 - 转为 ISO 风格（周一=1）：
{$add: [{$dayOfWeek: "$order_time"}, -1]}，再对 0 做特殊处理（周日变 0 → 改成 7）：{$cond: [{eq: [{$dayOfWeek: "$order_time"}, 1]}, 7, {$subtract: [{$dayOfWeek: "$order_time"}, 1]}]} - 若字段可能为
null或无效日期，$dayOfWeek也返回null，建议前置$ifNull或$cond容错
聚合中同时提取多个时间单位：别重复解析日期
一次 $dateFromString 或 $toDate 解析开销不小，尤其在大数据量聚合时。如果需要同时取小时、星期、年份等，应把解析结果存进临时字段，再复用——避免对同一字段反复调用转换操作符。
- 错误写法：多次独立调用
$toDate，导致重复解析 - 推荐写法：用
$let或第一层$addFields提前转好，例如：{$addFields: {parsed_date: {$toDate: "$ts"}}}，后续所有$hour、$dayOfWeek都基于$parsed_date - 注意内存：临时字段会增加文档体积，高频聚合中需权衡可读性与资源消耗
聚合阶段顺序影响结果：$project 里不能依赖未定义字段
$hour 和 $dayOfWeek 是表达式操作符，只能在支持表达式的阶段使用，比如 $project、$addFields、$group 的 $sum 表达式内部。它们**不能**直接用在 $match 阶段作为查询条件（除非配合 $expr）。
- 想按“星期几 = 2”筛选？必须写：
{$match: {$expr: {$eq: [{$dayOfWeek: "$dt"}, 2]}}} - 在
$group中按小时分桶：{$group: {_id: {$hour: "$ts"}, count: {$sum: 1}}}是合法的 - 嵌套表达式里出错难调试：比如
{$hour: {$toDate: "$str_ts"}}若$str_ts格式不对，整个字段为null，不会抛异常
最易被忽略的是时区隐含行为和字符串日期的静默失败——这两点在线上聚合任务里常导致统计偏差，却很难一眼发现。
