專案常需依「週」為單位統計報表、排程或顯示週曆。本函數 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 年共有 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
date('w') (0=週日) 更直觀。<?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;
}
?>