MongoDB怎样提取日期中的小时或星期几_利用$hour或$dayOfWeek算子

$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，不会抛异常

最易被忽略的是时区隐含行为和字符串日期的静默失败——这两点在线上聚合任务里常导致统计偏差，却很难一眼发现。