17370845950

本文介绍如何基于 mongodb 中的日期范围数据（如 blackout 区间），在 javascript 中高效构建整月日期数组，并为每一天准确标注 `available` 或 `booked` 状态，避免低效的逐日嵌套遍历。

在日程管理、预约系统或资源调度类应用中，常需将数据库中零散的日期区间（如 blackout、maintenance）映射到连续的日期序列上，生成结构化日历视图。直接对每月 31 天逐一查询数据库显然不可取；而若先拉取全部可用性记录再做内存匹配，则需确保逻辑既准确又高效。

核心思路是：预定义目标月份的起止日期 → 按天递增生成日期字符串 → 对每一天，一次性检查是否落在任一已知 blackout 区间内。关键优化点在于：

• ✅ 使用 Date 对象原生比较（而非字符串解析），提升判断效率；
• ✅ 利用 Array.prototype.some() 短路机制，一旦匹配即终止当前日期的遍历；
• ✅ 将 ISO 字符串统一截取为 YYYY-MM-DD 格式，消除时区与时间部分干扰；
• ✅ 所有计算在内存中完成，无需多次 I/O 或复杂聚合。

以下是完整可运行示例（兼容 Node.js 与现代浏览器）：

const availabilities = [
  {
    "_id": "64b03ed794d87927a3066e13",
    "startDateTime": "2025-07-07T18:00:00.000Z",
    "endDateTime": "2025-07-12T15:00:00.000Z",
    "availabilityType": "blackout"
  },
  {
    "_id": "64b03eb094d87927a3066ddb",
    "startDateTime": "2025-07-03T18:00:00.000Z",
    "endDateTime": "2025-07-06T15:00:00.000Z",
    "availabilityType": "blackout"
  }
];

// 定义目标月份范围（建议使用 Date.UTC 避免本地时区偏移）
const startDate = new Date(Date.UTC(2025, 6, 1));   // 2025-07-01（注意：月份从 0 开始）
const endDate = new Date(Date.UTC(2025, 6, 31));   // 2025-07-31

const result = [];
let currentDate = new Date(startDate);

while (currentDate <= endDate) {
  const dateStr = currentDate.toISOString().slice(0, 10); // "YYYY-MM-DD"

  const isBooked = availabilities.some(({ startDateTime, endDateTime, availabilityType }) => {
    if (availabilityType !== 'blackout') return false;

    const start = new Date(startDateTime).toISOString().slice(0, 10);
    const end = new Date(endDateTime).toISOString().slice(0, 10);

    return dateStr >= start && dateStr <= end;
  });

  result.push({
    date: dateStr,
    availabilityType: isBooked ? 'booked' : 'available'
  });

  currentDate.setDate(currentDate.getDate() + 1);
}

console.log(result);
// 输出包含 31 个对象的数组，每项含 date 和 availabilityType 字段

⚠️ 注意事项：

• 若数据量极大（如数千条 availabilities），可进一步优化：预先将所有 blackout 区间合并去重（避免重叠区间重复判定），再用二分查找判断日期归属；
• 生产环境建议将 startDate/endDate 抽离为函数参数，并增加输入校验（如确保 endDate >= startDate）；
• 若需支持多种 availabilityType（如 "maintenance"、"limited"），可扩展映射逻辑，而非硬编码 blackout；
• 注意 new Date(...) 在解析 ISO 字符串时默认按 UTC 解析，但 .toISOString() 返回 UTC 时间——因此统一使用 Date.UTC() 初始化起止日期可彻底规避本地时区偏差。

该方案平衡了可读性、性能与健壮性，适用于中小规模业务场景，是前端日历渲染与后端 API 数据预处理的理想实践。