JS：获取当前日期是本年度的第几周

一、背景与问题

在开发日历类应用、报表系统或数据统计系统时，常常需要将日期映射到周维度。例如在日志分析系统中，需要按周聚合数据；在项目管理工具中，需要显示当前周的待办事项。

然而，JavaScript 的 Date 对象本身并没有直接提供获取"年度第几周"的功能，这导致开发者需要自己实现逻辑。由于不同地区对周的定义存在差异（如ISO标准 vs 美国标准），实现时需要特别注意时区、周起始日（周一或周日）、跨年边界等问题。

二、基本原理

计算年度第几周的核心原理是：

确定日期在年份中的位置（以年份起始日为基准）
计算该日期距离年份起始日的天数
根据周起始日（如周一或周日）计算周数

关键点在于处理时区差异和周边界条件。例如：

某些年份的1月4日可能属于上一年的第52周
闰年2月29日的处理
跨年日期（如12月31日和1月1日）的归属

三、环境准备

确保开发环境支持ES6+，推荐使用Node.js或现代浏览器。需要处理的场景包括：

// 示例：获取当前日期
const today = new Date();
console.log(today);

四、核心实现

1. 基础实现（ISO 8601标准）

ISO 8601 标准规定：

周从周一到周日
每周从周一开始
1月4日可能属于上一年的第52周

function getWeekOfYear(date) {
  const jan1 = new Date(date.getFullYear(), 0, 1);
  const jan1NextYear = new Date(date.getFullYear(), 0, 1, 0, 0, 0, 0);
  const milliseconds = date - jan1;
  const days = Math.floor(milliseconds / 1000 / 60 / 60 / 24);
  
  // 计算周数（从周一作为周开始）
  const week = Math.floor((days + 1) / 7);
  
  // 处理跨年边界情况
  if (week < 1) {
    return 52;
  }
  
  return week;
}

关键代码解释：

jan1 计算当前年份的1月1日
milliseconds 计算当前日期距离1月1日的毫秒数
days 转换为天数
通过 (days + 1) / 7 计算周数（因为ISO标准周从周一开始）
特殊处理当周数小于1时返回52（处理跨年边界）

2. 不同地区标准的处理

美国标准（周日为周起始）与欧洲标准（周一为周起始）的差异：

function getWeekByRegion(date, startOfWeek = 1) {
  const jan1 = new Date(date.getFullYear(), 0, 1);
  const jan1NextYear = new Date(date.getFullYear(), 0, 1, 0, 0, 0, 0);
  const milliseconds = date - jan1;
  const days = Math.floor(milliseconds / 1000 / 60 / 60 / 24);
  
  // 调整周起始日（startOfWeek: 0=周日, 1=周一）
  const adjustedDays = days + (startOfWeek === 1 ? 1 : 0);
  
  const week = Math.floor((adjustedDays + 1) / 7);
  
  if (week < 1) {
    return 52;
  }
  
  return week;
}

关键差异：

startOfWeek 参数控制周起始日
调整天数计算时增加1天（周一作为周起始时）

3. 使用第三方库（date-fns）

对于复杂需求，推荐使用date-fns库：

npm install date-fns

import { startOfYear, differenceInCalendarDays, format } from 'date-fns';

function getWeekWithDateFns(date) {
  const startOfYear = startOfYear(date);
  const days = differenceInCalendarDays(date, startOfYear);
  
  // 周起始日为周一（ISO标准）
  const adjustedDays = days + 1; // 调整为从周一为0
  const week = Math.floor(adjustedDays / 7) + 1;
  
  return week;
}

优势：

更简洁的API
内置时区处理
更好的边界条件处理

五、完整案例

日历组件中的周数显示

<!DOCTYPE html>
<html>
<head>
  <title>Week Number Example</title>
</head>
<body>
  <div id="calendar"></div>
  <script>
    function getWeekOfYear(date) {
      const jan1 = new Date(date.getFullYear(), 0, 1);
      const jan1NextYear = new Date(date.getFullYear(), 0, 1, 0, 0, 0, 0);
      const milliseconds = date - jan1;
      const days = Math.floor(milliseconds / 1000 / 60 / 60 / 24);
      
      const week = Math.floor((days + 1) / 7);
      return week < 1 ? 52 : week;
    }

    function renderCalendar() {
      const today = new Date();
      const year = today.getFullYear();
      const week = getWeekOfYear(today);
      
      const calendarDiv = document.getElementById('calendar');
      calendarDiv.innerHTML = `当前日期：${today.toDateString()}<br>本年度第${week}周`;
    }

    renderCalendar();
  </script>
</body>
</html>

案例说明：

显示当前日期和对应周数
处理跨年边界情况
简单的UI展示

六、源码解析

以ISO标准实现为例：

function getWeekOfYear(date) {
  const jan1 = new Date(date.getFullYear(), 0, 1);
  const jan1NextYear = new Date(date.getFullYear(), 0, 1, 0, 0, 0, 0);
  const milliseconds = date - jan1;
  const days = Math.floor(milliseconds / 1000 / 60 / 60 / 24);
  
  const week = Math.floor((days + 1) / 7);
  
  if (week < 1) {
    return 52;
  }
  
  return week;
}

逐行解释：

jan1 计算当前年份的1月1日
jan1NextYear 用于处理跨年边界
milliseconds 计算日期差值
days 转换为天数
(days + 1)/7 计算周数（因为ISO标准周从周一开始）
特殊处理当周数小于1时返回52

七、进阶使用

1. 动态计算任意日期的周数

function getWeekOfYear(date) {
  // 处理时区问题
  const utcDate = new Date(date.getTime() + date.getTimezoneOffset() * 60 * 1000);
  
  const jan1 = new Date(utcDate.getFullYear(), 0, 1);
  const jan1NextYear = new Date(utcDate.getFullYear(), 0, 1, 0, 0, 0, 0);
  const milliseconds = utcDate - jan1;
  const days = Math.floor(milliseconds / 1000 / 60 / 60 / 24);
  
  const week = Math.floor((days + 1) / 7);
  
  if (week < 1) {
    return 52;
  }
  
  return week;
}

改进点：

处理时区差异（使用UTC时间计算）

2. 周数范围校验

function validateWeek(weekNumber, year) {
  if (weekNumber < 1) {
    throw new Error(`周数必须大于0，当前周数：${weekNumber}`);
  }
  
  if (weekNumber > 53) {
    throw new Error(`周数不能超过53，当前周数：${weekNumber}`);
  }
  
  const date = new Date(year, 0, 1);
  const startOfYear = new Date(date.getTime());
  const endOfYear = new Date(year, 11, 31);
  
  if (weekNumber === 53) {
    const lastWeek = new Date(year, 11, 31);
    const lastWeekDay = lastWeek.getDay(); // 0=周日, 1=周一...
    
    if (lastWeekDay < 1) {
      throw new Error(`年度第53周不存在，当前年份：${year}`);
    }
  }
}

用途：

验证周数是否在合法范围内
确保周数对应实际日期

八、性能与工程实践

性能优化

对于高频调用场景（如实时日历更新）：

const weekCache = {};

function getWeekOfYear(date) {
  const key = date.toISOString();
  
  if (weekCache[key] !== undefined) {
    return weekCache[key];
  }
  
  // 原始计算逻辑...
  
  weekCache[key] = week;
  return week;
}

优化策略：

使用缓存避免重复计算
使用弱引用缓存（对于内存敏感场景）

异常处理

function safeGetWeekOfYear(date) {
  try {
    if (!date || !(date instanceof Date)) {
      throw new TypeError('参数必须是Date对象');
    }
    
    if (isNaN(date.getTime())) {
      throw new RangeError('无效的日期');
    }
    
    return getWeekOfYear(date);
  } catch (error) {
    console.error('获取周数时发生错误:', error);
    return null;
  }
}

处理场景：

防止无效输入导致程序崩溃
记录异常信息便于调试

九、常见问题与踩坑

1. 跨年边界错误

错误示例：

function getWeekOfYear(date) {
  const days = (date - new Date(date.getFullYear(), 0, 1)) / 86400000;
  return Math.floor(days / 7) + 1;
}

问题分析：

未处理跨年边界（如12月31日可能属于上一年的第52周）
未考虑周起始日差异

改进方案：

function getWeekOfYear(date) {
  const jan1 = new Date(date.getFullYear(), 0, 1);
  const jan1NextYear = new Date(date.getFullYear(), 0, 1, 0, 0, 0, 0);
  const milliseconds = date - jan1;
  const days = Math.floor(milliseconds / 1000 / 60 / 60 / 24);
  
  const week = Math.floor((days + 1) / 7);
  
  if (week < 1) {
    return 52;
  }
  
  return week;
}

2. 时区处理错误

错误示例：

function getWeekOfYear(date) {
  const days = (date - new Date(date.getFullYear(), 0, 1)) / 86400000;
  return Math.floor(days / 7) + 1;
}

问题分析：

使用本地时区可能导致计算错误
不同时区的日期差异会影响结果

改进方案：

function getWeekOfYear(date) {
  const utcDate = new Date(date.getTime() + date.getTimezoneOffset() * 60 * 1000);
  const jan1 = new Date(utcDate.getFullYear(), 0, 1);
  const milliseconds = utcDate - jan1;
  const days = Math.floor(milliseconds / 1000 / 60 / 60 / 24);
  
  const week = Math.floor((days + 1) / 7);
  
  if (week < 1) {
    return 52;
  }
  
  return week;
}

十、最佳实践

1. 推荐方案

对于简单需求：使用原生Date对象+手动计算
对于复杂需求：使用date-fns等成熟库
对于国际化需求：使用moment-timezone或Luxon

2. 推荐实践

始终使用UTC时间进行计算
对于频繁调用场景使用缓存
对于关键业务逻辑添加验证
对于跨时区场景使用时区转换

3. 推荐代码结构

// utils/weekUtils.js
export function getWeekOfYear(date) {
  // 实现逻辑
}

export function getWeekByRegion(date, startOfWeek = 1) {
  // 实现逻辑
}

十一、总结

获取当前日期是本年度的第几周是JavaScript开发中的常见需求，但实现时需要考虑多方面因素：

不同地区的周计算标准
时区差异
跨年边界处理
性能需求

本文深入分析了不同实现方式，对比了原生方法与第三方库的优劣，提出了性能优化和异常处理方案。在实际开发中，建议根据具体需求选择合适的方法：对于简单场景使用原生方法，对于复杂需求使用成熟库。同时要特别注意时区处理和边界条件，避免因小错误导致整个系统逻辑错误。

JS：获取当前日期是本年度的第几周

JS：获取当前日期是本年度的第几周

一、背景与问题

二、基本原理

三、环境准备

四、核心实现

1. 基础实现（ISO 8601标准）

2. 不同地区标准的处理

3. 使用第三方库（date-fns）

五、完整案例

日历组件中的周数显示

六、源码解析

七、进阶使用

1. 动态计算任意日期的周数

2. 周数范围校验

八、性能与工程实践

性能优化

异常处理

九、常见问题与踩坑

1. 跨年边界错误

2. 时区处理错误

十、最佳实践

1. 推荐方案

2. 推荐实践

3. 推荐代码结构

十一、总结

评论已关闭

推荐阅读