PHP如何获取某年某周的开始和结束日期

# PHP如何获取某年某周的开始和结束日期

在开发日历、统计报表或计划管理系统时，经常需要根据年份和周数计算特定周的开始和结束日期。本文将详细介绍5种PHP实现方案，并提供完整代码示例和性能对比。

## 一、DateTime类方案（推荐）

PHP 5.2+引入的DateTime类提供了最优雅的解决方案：

```php
function getWeekDates($year, $week) {
    $date = new DateTime();
    $date->setISODate($year, $week);
    $start = $date->format('Y-m-d');
    
    $date->modify('+6 days');
    $end = $date->format('Y-m-d');
    
    return ['start' => $start, 'end' => $end];
}

// 示例：获取2023年第10周日期
$weekDates = getWeekDates(2023, 10);
echo "开始日期：{$weekDates['start']}, 结束日期：{$weekDates['end']}";

优点： - 代码简洁直观 - 自动处理闰年等特殊情况 - 支持时区设置

二、strtotime函数方案

适合PHP 5.3以下版本：

function getWeekDatesLegacy($year, $week) {
    $timestamp = strtotime("{$year}-W{$week}");
    $start = date('Y-m-d', $timestamp);
    $end = date('Y-m-d', strtotime('+6 days', $timestamp));
    
    return compact('start', 'end');
}

注意：周数需要补前导零（如”05”）

三、跨年周的特殊处理

当周数跨越年份时（如2022年第52周）：

function getSafeWeekDates($year, $week) {
    $date = new DateTime();
    $date->setISODate($year, $week);
    $actualYear = $date->format('o'); // 获取实际ISO年份
    
    if($actualYear != $year) {
        throw new Exception("该周实际属于年份：{$actualYear}");
    }
    
    // ...其余逻辑相同...
}

四、周定义的国际差异

不同地区对”一周开始”的定义不同：

美标实现示例：

function getUSWeekDates($year, $week) {
    $date = new DateTime("January 1 {$year}");
    $date->modify('+' . ($week - 1) . ' weeks');
    
    // 调整到周日
    while($date->format('w') != 0) {
        $date->modify('-1 day');
    }
    
    $start = $date->format('Y-m-d');
    $date->modify('+6 days');
    $end = $date->format('Y-m-d');
    
    return compact('start', 'end');
}

五、性能对比测试

我们对10万次调用进行测试：

结论：虽然strtotime稍快，但DateTime在可读性和功能性上更优。

六、完整工具类实现

class WeekCalculator {
    const FORMAT_ISO = 'Y-m-d';
    const FORMAT_US = 'm/d/Y';
    
    public static function getWeekRange(
        int $year, 
        int $week, 
        string $format = self::FORMAT_ISO,
        bool $isoStandard = true
    ): array {
        $date = new DateTime();
        
        if($isoStandard) {
            $date->setISODate($year, $week);
            $start = $date->format($format);
            $date->modify('+6 days');
        } else {
            // 美标实现逻辑
        }
        
        return [
            'start' => $start,
            'end' => $date->format($format),
            'year' => $date->format('o'),
            'week' => $date->format('W')
        ];
    }
}

七、常见问题解决方案

1. 周数超出范围：

   if($week < 1 || $week > 53) {
      throw new InvalidArgumentException("周数必须在1-53之间");
   }
   

2. 时区问题：

   $date = new DateTime('now', new DateTimeZone('Asia/Shanghai'));
   

3. 多语言格式化：

   $formatter = new IntlDateFormatter(
      'fr_FR', 
      IntlDateFormatter::FULL, 
      IntlDateFormatter::FULL
   );
   echo $formatter->format($date);
   

八、最佳实践建议

1. 始终明确周计算标准（ISO/美标）
2. 对用户输入的周数进行验证
3. 考虑使用缓存机制提高性能
4. 在API响应中包含实际年份信息

通过以上方法，您可以可靠地在PHP中实现周日期计算功能，满足各种业务场景需求。 “`