统计日期列表中的天数、周末数与月份数（JavaScript 实现）_技术教程

本文介绍如何使用 javascript 快速统计一个 iso 格式日期字符串数组中包含的总天数、周末天数（周六/周日）以及“属于每月第一天”的日期数量，并输出结构化结果对象。

在日常数据处理中，我们常需从时间序列中提取高频统计维度，例如：某服务日志中各日期的分布特征、用户活跃时段分析、或财务周期对齐等场景。给定一组 ISO 8601 格式的 UTC 时间字符串（如 "2025-02-01T23:00:00.000Z"），目标是高效计算三项关键指标：

day：日期总数（即数组长度）；
weekend：落在周六（getDay() === 6）或周日（getDay() === 0）的日期数量；
month：为当月第一天（getDate() === 1）的日期数量。

以下提供三种渐进式实现方案，兼顾可读性、健壮性与简洁性：

✅ 方案一：基础循环（推荐初学者理解逻辑）

const dateList = [
  "2025-01-31T23:00:00.000Z",
  "2025-02-01T23:00:00.000Z",
  "2025-02-02T23:00:00.000Z",
  "2025-02-03T23:00:00.000Z"
];

let dayCount = 0;
let weekendCount = 0;
let monthCount = 0;

dateList.forEach(dateStr => {
  const date = new Date(dateStr);

  // 验证日期有效性（重要！避免无效字符串导致 NaN）
  if (isNaN(date.getTime())) {
    console.warn(`Invalid date string skipped: ${dateStr}`);
    return;
  }

  dayCount++;

  // 周末判断：星期日=0，星期六=6
  if (date.getDay() === 0 || date.getDay() === 6) {
    weekendCount++;
  }

  // 每月第一天判断（注意：基于本地时区解析！见下方注意事项）
  if (date.getDate() === 1) {
    monthCount++;
  }
});

const result = { day: dayCount, weekend: weekendCount, month: monthCount };
console.log(result); // { day: 4, weekend: 1, month: 1 }

✅ 方案二：函数式风格（更简洁、易测试）

const dateList = [/* 同上 */];

const isValidDate = (str) => !isNaN(new Date(str).getTime());
const isWeekend = (str) => {
  const d = new Date(str);
  return d.getDay() === 0 || d.getDay() === 6;
};
const isFirstDayOfMonth = (str) => new Date(str).getDate() === 1;

const result = {
  day: dateList.length,
  weekend: dateList.filter(isWeekend).length,
  month: dateList.filter(isFirstDayOfMonth).length
};

console.log(result);

✅ 方案三：一行式（适合已验证数据的轻量场景）

const dateList = [/* 同上 */];
const result = {
  day: dateList.length,
  weekend: dateList.filter(s => [0,6].includes(new Date(s).getDay())).length,
  month: dateList.filter(s => new Date(s).getDate() === 1).length
};

⚠️ 关键注意事项

时区陷阱：new Date("2025-02-01T23:00:00.000Z") 在 UTC 中是 2025-02-01，但在东八区（GMT+8）环境下调用 .getDate() 会返回 2025-02-02 的日期值（即 2）。若需严格按 UTC 逻辑判断“每月第一天”，应使用：
```
const utcDate = new Date(dateStr);
const isUtcFirstDay = utcDate.getUTCDate() === 1; // 使用 getUTCDate()
```
无效日期防护：务必校验 new Date(str).getTime() 是否为 NaN，否则无效字符串（如 "invalid"）会导致 getDay() 返回 NaN，进而影响逻辑。
语义澄清：“Months” 在本例中指 列表中出现的“每月1号”的次数，而非跨多少个不同自然月（如需后者，应使用 Set 去重 YYYY-MM）。

通过以上任一方法，你均可将原始日期数组转化为标准统计对象 { day, weekend, month }，为后续可视化、告警或聚合分析提供可靠输入。