萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 獲取指定年份每週起止日期的完整解決方案

需求背景

在開發周報、考勤統計、課程排程等功能時,常需要根據年份與週數快速獲得該週的起始日期(週一)與結束日期(週日)。本文提供一個健壯的 get_week() 函數,並說明其核心邏輯與使用方式。

核心函數實現

function get_week($year) {
    // 年度首尾日期
    $year_start = "$year-01-01";
    $year_end   = "$year-12-31";

    // 取得該年第一天的時間戳
    $startday = strtotime($year_start);

    // 若 1 月 1 日非週一,則往前推至第一個週一
    if (intval(date('N', $startday)) !== 1) {
        $startday = strtotime("next monday", strtotime($year_start));
    }
    $year_monday = date("Y-m-d", $startday); // 第一周週一日期

    // 處理年底邊界:若 12/31 屬於第 53 週(ISO 週數),取該年最後一個週日
    $endday = strtotime($year_end);
    if (intval(date('W', $endday)) == 53) { // 注意:ISO 週數最大 53
        $endday = strtotime("last sunday", strtotime($year_end));
    }
    $total_weeks = intval(date('W', $endday)); // 該年總週數

    // 迴圈生成每週起止日期
    $week_array = [];
    for ($i = 1; $i <= $total_weeks; $i++) {
        $offset = $i - 1;
        $start_date = date("Y-m-d", strtotime("$year_monday +$offset weeks"));
        $end_date   = date("Y-m-d", strtotime("$start_date +6 days"));

        // 格式化為 YYYY.MM.DD
        $week_array[$i] = [
            str_replace('-', '.', $start_date),
            str_replace('-', '.', $end_date)
        ];
    }
    return $week_array;
}

使用範例

$weeks = get_week(2011);
echo "第 18 週起始:" . $weeks[18][0]; // 2011.05.02
echo "第 18 週結束:" . $weeks[18][1]; // 2011.05.08

邏輯要點解析

  1. ISO 8601 週數標準:PHP date('W') 返回 ISO 週數(週一為每週第一天),符合國際慣例。
  2. 跨年週處理:若 1/1 非週一,則屬於上一年最後一週;同理 12/31 可能屬於下一年第一週。代碼透過 next monday 與 last sunday 修正邊界。
  3. 效能考量:函數僅使用時間戳運算,無資料庫查詢,效能極佳,適合高頻調用。

進階擴展

  • 支援傳入 DateTime 物件而非年份字串
  • 增加 timezone 參數處理跨時區業務
  • 回傳結構改為 ['week' => $i, 'start' => ..., 'end' => ...] 便於前端直接渲染
copyright © 萬盛學電腦網 all rights reserved