Collectors.groupingBy按时间维度汇总的核心是时间字段归一化为分组键（如YearMonth、周起始日、小时），再组合下游收集器聚合；需注意键设计语义准确、避免keyMapper中复杂计算、补全缺失区间、控制嵌套层级，并验证边界日期。
用 Collectors.groupingBy 按时间维度汇总业务流水，核心是把时间字段“归一化”成可分组的键（比如年月、周、小时），再结合下游收集器做聚合统计。关键不在 groupingBy 本身，而在时间键的设计和聚合逻辑的组合。
按年月（yyyy-MM）分组统计流水总额
适合月度报表，需将 LocalDateTime 或 Date 转为 “2024-03” 这样的字符串键或 YearMonth 对象。
- 推荐用
YearMonth.from(time)作分组键——类型安全、可比较、无字符串解析开销 - 下游接
Collectors.summingDouble(Trade::getAmount)直接求和 - 若需同时统计笔数、最大单笔、平均金额，用
Collectors.collectingAndThen包装自定义 Collector，或改用Collectors.toMap+ 自定义映射函数
按自然周（周一至周日）分组并保留起止日期
单纯 groupingBy 得不到周区间，需预计算每条记录所属周的起始日（如 2024-03-11）作为键，再用 Map 的 value 存封装了统计值和区间信息的对象。
- 先用
temporal.with(DayOfWeek.MONDAY).withHour(0).withMinute(0)算出当周周一 0 点 Instant - 分组键用该 Instant（或 LocalDate），value 用
Collectors.collectingAndThen(..., stats -> new WeeklyReport(key, stats)) - 避免在 groupingBy 的 keyMapper 中做复杂计算——影响可读性和性能，建议提前映射好 key 字段
按交易小时（HH）聚合，并补全缺失小时（0–23）
groupingBy 默认只返回有数据的小时，要展示完整 24 小时需后续补零。推荐两步走：
- 先用
Collectors.groupingBy(t -> t.getTimestamp().getHour(), Collectors.summingDouble(Trade::getAmount))得到 Map - 再用
IntStream.rangeClosed(0, 23).boxed().collect(Collectors.toMap(i -> i, hour -> result.getOrDefault(hour, 0.0)))补全 - 不建议强行在 groupingBy 里初始化 24 个键——违背其设计语义，也难维护
多级时间分组：先按年月，再按交易类型
嵌套 groupingBy 可实现树状结构，例如 {“2024-03”: {“PAY”: 12000.0, “REFUND”: -800.0}}。
- 写法：
Collectors.groupingBy(t -> YearMonth.from(t.getTime()), Collectors.groupingBy(Trade::getType, Collectors.summingDouble(Trade::getAmount))) - 注意第二层 collector 返回的是
Map，不是扁平列表；如需展平为 List，后续用 entrySet().stream() 处理 - 层级越深，内存占用和调试难度越高，建议超过两层时拆成多个独立流操作
groupingBy 是工具，不是银弹。真正决定报表质量的是时间键的语义准确性、空值/时区/夏令时的处理，以及是否配合 toMap、flatMapping 等更灵活的收集器。写完记得用小样本验证边界日期（如月末最后秒、跨年瞬间）的行为。
