萬盛學電腦網

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

PHP 取得指定年份每週起始與結束日期

PHP 取得指定年份每週起始與結束日期

專案常需依「週」為單位統計報表、排程或顯示週曆。本函數 get_week($year) 回傳該年每週的起始日 (週一) 與結束日 (週日) 陣列,採 ISO-8601 週數定義 (週一為週首)。

核心函數程式碼

<?php
/**
 * 取得指定年份每週的起始與結束日期
 * @param int $year 年份 (如 2024)
 * @return array 索引 1~52/53,值為 [起始日期, 結束日期] (格式 Y.m.d)
 */
function get_week(int $year): array {
    $yearStart = "$year-01-01";
    $yearEnd   = "$year-12-31";

    // 1. 找到該年第一個週一
    $firstMonTs = strtotime($yearStart);
    if ((int)date('N', $firstMonTs) !== 1) { // N=1 代表週一
        $firstMonTs = strtotime('next monday', $firstMonTs);
    }
    $firstMon = date('Y-m-d', $firstMonTs);

    // 2. 取得該年最後一週的週數
    $lastTs = strtotime($yearEnd);
    // 如果 12/31 是週日 (W=7 且 N=7),往前推到該週週一
    if ((int)date('W', $lastTs) === 7 && (int)date('N', $lastTs) === 7) {
        $lastTs = strtotime('last sunday', $lastTs);
    }
    $totalWeeks = (int)date('W', $lastTs); // 該年總週數 (52 或 53)

    // 3. 逐週產生日期範圍
    $weeks = [];
    for ($i = 1; $i <= $totalWeeks; $i++) {
        $offset = ($i - 1) * 7 * 86400; // 秒數偏移
        $startTs = $firstMonTs + $offset;
        $endTs   = $startTs + 6 * 86400;

        $weeks[$i] = [
            date('Y.m.d', $startTs), // 起始日 (週一)
            date('Y.m.d', $endTs)    // 結束日 (週日)
        ];
    }
    return $weeks;
}
?>

使用範例

<?php
$weeks = get_week(2024);

echo "2024 年共有 " . count($weeks) . " 週\n\n";

// 取得第 18 週
$weekNo = 18;
if (isset($weeks[$weekNo])) {
    echo "第 {$weekNo} 週:{$weeks[$weekNo][0]} ~ {$weeks[$weekNo][1]}\n";
    // 輸出:第 18 週:2024.04.29 ~ 2024.05.05
}

// 列印前 5 週示範
for ($i = 1; $i <= 5; $i++) {
    echo "第 $i 週:{$weeks[$i][0]} ~ {$weeks[$i][1]}\n";
}
?>

輸出結果 (2024 年前 5 週)

2024 年共有 52 週

第 1 週:2024.01.01 ~ 2024.01.07
第 2 週:2024.01.08 ~ 2024.01.14
第 3 週:2024.01.15 ~ 2024.01.21
第 4 週:2024.01.22 ~ 2024.01.28
第 5 週:2024.01.29 ~ 2024.02.04

邏輯關鍵點

  1. date('N'):ISO-8601 星期數 (1=週一 ... 7=週日),比 date('w') (0=週日) 更直觀。
  2. strtotime('next monday'):若 1/1 非週一,自動跳到下一個週一作為第一週起始。
  3. date('W'):ISO 週數 (01~53),直接給出該日期屬於第幾週。
  4. 跨年週處理:12/31 若屬於下一年的第 1 週,不計入本年週數;反之 1/1 若屬去年最後一週,也不計入本年。

DateTime 物件導向寫法 (PHP 5.2+ 推薦)

<?php
function getWeekDateTime(int $year): array {
    $weeks = [];
    $dt = new DateTime("$year-01-01", new DateTimeZone('Asia/Shanghai'));

    // 移到第一個週一
    $dt->modify('monday this week');
    if ($dt->format('Y-m-d') < "$year-01-01") {
        $dt->modify('next monday');
    }

    $endYear = new DateTime("$year-12-31", new DateTimeZone('Asia/Shanghai'));
    $endYear->modify('sunday this week'); // 確保覆蓋最後一週

    $week = 1;
    while ($dt <= $endYear) {
        $start = clone $dt;
        $end = clone $dt;
        $end->modify('+6 days');

        $weeks[$week++] = [
            $start->format('Y.m.d'),
            $end->format('Y.m.d')
        ];
        $dt->modify('+1 week');
    }
    return $weeks;
}
?>

應用場景

  • 週報表自動產生器 (依週號查詢資料範圍)
  • 後台管理:週曆顯示、週期性任務排程
  • 薪資/考勤系統:依週計算工時、加班
  • 行銷分析:同比/環比週數對齊
copyright © 萬盛學電腦網 all rights reserved