通过Symbol.iterator为报表对象实现按自然周(周一至周日)切分的迭代逻辑,动态计算每周起止日期并聚合对应营业数据,支持52/53周、跨年处理及严格日历年约束,内存友好且兼容for...of与扩展运算符。

直接用 Symbol.iterator 为报表对象定义迭代逻辑,按自然周(周一至周日)切分全年日期,逐周生成结构化数据项,无需先展开再合并。
按周生成时间区间并映射到报表数据
一年内周数不固定(52 或 53 周),不能硬编码循环 52 次。应从年初第一个周一算起,逐周推进,直到跨年为止。每轮迭代中:
- 计算当前周的起止日期(ISO 周标准:周一为每周第一天,周日为最后一天)
- 查找该周内所有营业记录(如
reportData.filter(item => dateInRange(item.date, weekStart, weekEnd))) - 聚合为单个周级对象,含
weekIndex、dateRange、items、summary等字段
实现自定义 Iterator 协议
让报表类(例如 YearlyReport)返回一个迭代器对象,其 next() 方法每次返回一周数据,并自动推进日期。关键点:
- 内部维护当前周的
start和end(Date 实例) -
next()中判断是否已超出本年 12 月 31 日,是则返回{ done: true } - 每次调用都生成新周对象,不预先缓存全部 53 个周——节省内存,支持大报表
兼容 for...of 和扩展运算符
只要正确实现 [Symbol.iterator]() 方法,就能无缝用于常见语法:
立即学习“Java免费学习笔记(深入)”;
for (const week of yearlyReport) { console.log(week.summary.totalRevenue); }const allWeeks = [...yearlyReport]; // 转为数组(按需触发)Array.from(yearlyReport, w => w.summary.avgOrderValue)
处理跨年周与边界情况
ISO 周可能把 12 月最后几天划入下一年第 1 周,或把 1 月前几天归为上一年第 53 周。若业务要求“严格按日历年内划分”,需在周区间判定时加约束:
- 只接受起始日期和结束日期都在同一年内的周(
weekStart.getFullYear() === year && weekEnd.getFullYear() === year) - 对首尾不完整的周(如 1 月 1 日是周三),可选择补全(填充空数据)或截断(仅包含当年日期)
- 避免用
getWeek()这类非标准方法,推荐用date-fns的getISOWeek或手写 ISO 周计算逻辑


















