本文介绍如何使用 javascript 快速统计一个 iso 格式日期字符串数组中包含的总天数、周末天数（周六/周日）以及“属于每月第一天”的日期数量，并输出结构化结果对象。
在日常数据处理中，我们常需从时间序列中提取高频统计维度，例如：某服务日志中各日期的分布特征、用户活跃时段分析、或财务周期对齐等场景。给定一组 ISO 8601 格式的 UTC 时间字符串（如 "2023-02-01T23:00:00.000Z"），目标是高效计算三项关键指标：
- day：日期总数（即数组长度）；
- weekend：落在周六（getDay() === 6）或周日（getDay() === 0）的日期数量；
- month：为当月第一天（getDate() === 1）的日期数量。
以下提供三种渐进式实现方案，兼顾可读性、健壮性与简洁性：
✅ 方案一：基础循环（推荐初学者理解逻辑）
const dateList = [
"2023-01-31T23:00:00.000Z",
"2023-02-01T23:00:00.000Z",
"2023-02-02T23:00:00.000Z",
"2023-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("2023-02-01T23:00:00.000Z") 在 UTC 中是 2023-02-01，但在东八区（GMT+8）环境下调用 .getDate() 会返回 2023-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 }，为后续可视化、告警或聚合分析提供可靠输入。
