PHP 获取当前周的起始与结束日期：全面指南与最佳实践220

在日常的Web开发中，我们经常需要处理日期和时间。其中一个非常常见的需求是获取当前周的起始日期和结束日期，这在开发日历应用、数据报表统计、周任务管理系统等场景中尤为重要。PHP提供了多种灵活的方式来处理日期和时间，从简单的函数到功能强大的面向对象API。本文将作为一份专业的指南，深入探讨如何在PHP中精准、高效地获取当前周的起始和结束日期，并提供最佳实践。

一、理解日期时间在PHP中的表示与挑战

在深入探讨具体方法之前，我们需要先理解PHP处理日期时间的基础知识及其可能遇到的挑战。

1. Unix时间戳

PHP内部处理日期时间的核心是Unix时间戳，它是一个整数，表示自1970年1月1日00:00:00 UTC（协调世界时）以来经过的秒数。例如，`time()` 函数返回当前时间的时间戳。

2. 日期字符串

人类可读的日期字符串是我们最常接触的格式，如“2023-10-26 10:30:00”。PHP的 `date()` 函数可以将时间戳格式化为日期字符串，而 `strtotime()` 函数则可以将日期字符串解析为时间戳。

3. 时区（Timezone）的挑战

日期时间操作最大的“坑”往往是时区。如果未正确设置或处理时区，你的应用程序可能会显示不正确的时间。PHP默认的时区可以通过 `` 中的 `` 设置，或在代码中使用 `date_default_timezone_set()` 函数动态设置。

4. 周的起始日约定

另一个关键点是“一周的起始日”。国际标准化组织（ISO 8601）规定周一为一周的第一天，周日为第七天。然而，在某些地区（如美国、加拿大），习惯上将周日作为一周的第一天。因此，在获取周的起始日期时，我们需要明确遵循哪种约定。

二、核心方法一：利用 `strtotime()` 和 `date()` 获取本周起始/结束日期

`strtotime()` 是PHP中一个非常强大的函数，它可以解析几乎所有英文文本的日期时间描述，并将其转换为Unix时间戳。结合 `date()` 函数，我们可以非常便捷地获取本周的起始和结束日期。

1. 以周一作为一周的起始（ISO 8601 标准）

这是最常见也最推荐的国际标准。<?php
// 确保设置正确的时区
date_default_timezone_set('Asia/Shanghai');
// 获取本周一的日期字符串
// 'monday this week' 会自动定位到当前周的周一
$startOfWeekMondayTimestamp = strtotime('monday this week');
$startOfWeekMonday = date('Y-m-d', $startOfWeekMondayTimestamp);
// 获取本周日的日期字符串
// 'sunday this week' 会自动定位到当前周的周日
$endOfWeekSundayTimestamp = strtotime('sunday this week');
$endOfWeekSunday = date('Y-m-d', $endOfWeekSundayTimestamp);
echo "当前周的起始日期 (周一): " . $startOfWeekMonday . "";
echo "当前周的结束日期 (周日): " . $endOfWeekSunday . "";
// 也可以直接获取周六作为结束日
$endOfWeekSaturdayTimestamp = strtotime('saturday this week');
$endOfWeekSaturday = date('Y-m-d', $endOfWeekSaturdayTimestamp);
echo "当前周的结束日期 (周六): " . $endOfWeekSaturday . "";
?>

这种方法简洁明了，`strtotime()` 能够智能地理解“this week”的上下文，并给出正确的周一或周日的时间戳。

2. 以周日作为一周的起始（美式约定）

如果你的业务场景要求周日作为一周的开始，`strtotime()` 也能派上用场，但需要注意一个潜在的细微差别：当“今天”就是周日时，`'sunday this week'` 可能会指向当前周的周日（也就是今天），而 `strtotime('last sunday')` 则会指向上周日。

为了确保获取的是当前周的周日（如果今天就是周日，则为今天；否则为上一个周日），最可靠的方法是结合 `date('w')` 获取星期几（0代表周日，6代表周六），然后进行日期计算。<?php
date_default_timezone_set('Asia/Shanghai');
$today = time(); // 当前时间戳
$dayOfWeek = date('w', $today); // 获取星期几，0表示周日，1表示周一...6表示周六
// 计算本周日（起始日）
// 如果今天是周日（$dayOfWeek为0），则起始日就是今天
// 否则，需要减去相应的天数来回溯到本周日
$startOfWeekSundayTimestamp = strtotime('-' . $dayOfWeek . ' days', $today);
$startOfWeekSunday = date('Y-m-d', $startOfWeekSundayTimestamp);
// 计算本周六（结束日）
// 在起始日的基础上加6天
$endOfWeekSaturdayTimestamp = strtotime('+6 days', $startOfWeekSundayTimestamp);
$endOfWeekSaturday = date('Y-m-d', $endOfWeekSaturdayTimestamp);
echo "当前周的起始日期 (周日): " . $startOfWeekSunday . "";
echo "当前周的结束日期 (周六): " . $endOfWeekSaturday . "";
?>

这种手动计算的方式虽然稍微复杂一点，但对于以周日为起始的场景更加精确和可控。

三、核心方法二：使用 `DateTime` 对象处理本周起始/结束日期（推荐）

PHP 5.2.0 引入的 `DateTime` 类及其相关类（如 `DateTimeImmutable`, `DateInterval`, `DateTimeZone`）提供了功能更强大、更面向对象的日期时间处理方式。它们提供了更好的可读性、可维护性和健鲁性，尤其是在处理复杂日期逻辑和时区问题时。

1. 以周一作为一周的起始（ISO 8601 标准）

<?php
// 创建一个DateTime对象，默认是当前时间
$dateTime = new DateTime('now', new DateTimeZone('Asia/Shanghai'));
// 将日期调整到本周的周一
$dateTime->modify('monday this week');
$startOfWeekMonday = $dateTime->format('Y-m-d');
// 为了获取周日，我们需要创建一个新的DateTime对象或克隆当前的，
// 因为 modify() 会改变原始对象
$endDateTime = clone $dateTime; // 克隆起始日期对象
$endDateTime->modify('+6 days'); // 从周一加6天就是周日
$endOfWeekSunday = $endDateTime->format('Y-m-d');
// 或者直接使用 'sunday this week'
$endDateTime2 = new DateTime('now', new DateTimeZone('Asia/Shanghai'));
$endDateTime2->modify('sunday this week');
$endOfWeekSunday2 = $endDateTime2->format('Y-m-d');

echo "[DateTime] 当前周的起始日期 (周一): " . $startOfWeekMonday . "";
echo "[DateTime] 当前周的结束日期 (周日): " . $endOfWeekSunday . " (通过+6天计算)";
echo "[DateTime] 当前周的结束日期 (周日): " . $endOfWeekSunday2 . " (通过直接修改计算)";
// 获取周六作为结束日
$endDateTimeSaturday = clone $dateTime; // 从周一开始
$endDateTimeSaturday->modify('+5 days'); // 周一 + 5天 = 周六
$endOfWeekSaturday = $endDateTimeSaturday->format('Y-m-d');
echo "[DateTime] 当前周的结束日期 (周六): " . $endOfWeekSaturday . "";
?>

使用 `DateTime` 对象配合 `modify()` 方法，提供了清晰且链式调用的方式来调整日期。`clone` 的使用保证了原始日期对象不受修改，这在需要基于同一时间点进行多次计算时非常有用。

2. 以周日作为一周的起始（美式约定）

<?php
$dateTime = new DateTime('now', new DateTimeZone('Asia/Shanghai'));
// 获取当前是星期几，'w' 格式：0（周日）到 6（周六）
$dayOfWeek = $dateTime->format('w');
// 将日期调整到本周的周日（起始日）
// 如果当前是周日，则 $dayOfWeek 是0，modify('-0 days') 不会改变日期
// 否则，会减去相应天数回到本周的周日
$startDateTimeSunday = clone $dateTime; // 克隆当前时间，避免修改原始对象
$startDateTimeSunday->modify('-' . $dayOfWeek . ' days');
$startOfWeekSunday = $startDateTimeSunday->format('Y-m-d');
// 获取本周的周六（结束日）
$endDateTimeSaturday = clone $startDateTimeSunday; // 从周日开始
$endDateTimeSaturday->modify('+6 days'); // 周日 + 6天 = 周六
$endOfWeekSaturday = $endDateTimeSaturday->format('Y-m-d');

echo "[DateTime] 当前周的起始日期 (周日): " . $startOfWeekSunday . "";
echo "[DateTime] 当前周的结束日期 (周六): " . $endOfWeekSaturday . "";
?>

这种方法与 `strtotime()` 结合手动计算的方式异曲同工，但封装在 `DateTime` 对象中，利用 `modify()` 使得代码更加清晰和易于维护。

四、时区（Timezone）处理的重要性

无论是使用 `strtotime()` 还是 `DateTime` 对象，正确处理时区都是至关重要的。未指定时区可能导致以下问题：
服务器和用户在不同时区时，显示的时间不一致。
夏令时（DST）转换时，可能出现时间偏差。

推荐的做法是：
全局设置：在 `` 中设置 ``，例如 ` = Asia/Shanghai`。
应用初始化设置：在应用程序的入口文件（如 `` 或框架的引导文件）中使用 `date_default_timezone_set('Your/Timezone')`。
`DateTime` 构造函数：在创建 `DateTime` 对象时，显式传入 `DateTimeZone` 对象，如 `new DateTime('now', new DateTimeZone('Asia/Shanghai'))`。这会覆盖全局设置，提供更精细的控制。

在本文的示例代码中，我们都显式地设置了时区，以确保结果的准确性。

五、封装成可复用的函数（最佳实践）

为了提高代码的复用性和可维护性，我们可以将上述逻辑封装成一个通用的函数。这个函数可以接受一个参数来决定周的起始日是周一还是周日，并返回一个包含起始和结束日期的数组或 `DateTime` 对象。<?php
/
* 获取当前周的起始和结束日期
*
* @param bool $startOnMonday true表示周一为起始，false表示周日为起始
* @param string|null $timezone 如果为null，则使用默认时区；否则使用指定时区
* @return array 包含'start'和'end' DateTime对象的数组
* @throws Exception 如果时区无效
*/
function getWeekRange(bool $startOnMonday = true, ?string $timezone = null): array
{
// 设置时区
$tz = new DateTimeZone($timezone ?? date_default_timezone_get());

// 创建当前日期的DateTime对象
$currentDateTime = new DateTime('now', $tz);
$startOfWeek = clone $currentDateTime;
$endOfWeek = clone $currentDateTime;
if ($startOnMonday) {
// ISO 8601 标准：周一为一周的起始
$startOfWeek->modify('monday this week');
$endOfWeek->modify('sunday this week');
} else {
// 美式约定：周日为一周的起始
// 获取当前是星期几，'w' 格式：0（周日）到 6（周六）
$dayOfWeek = $currentDateTime->format('w');

$startOfWeek->modify('-' . $dayOfWeek . ' days'); // 回溯到本周日
$endOfWeek->modify('+6 days'); // 从周日开始加6天到周六
}

// 将时间部分重置为00:00:00和23:59:59，确保获取的是一整天
$startOfWeek->setTime(0, 0, 0);
$endOfWeek->setTime(23, 59, 59);
return [
'start' => $startOfWeek,
'end' => $endOfWeek,
];
}
// 示例用法：
// 1. 获取以周一为起始的本周范围 (默认)
$weekRangeMondayStart = getWeekRange(true, 'Asia/Shanghai');
echo "以周一为起始的本周范围：";
echo " 起始日期: " . $weekRangeMondayStart['start']->format('Y-m-d H:i:s') . "";
echo " 结束日期: " . $weekRangeMondayStart['end']->format('Y-m-d H:i:s') . "";
echo "<hr>";
// 2. 获取以周日为起始的本周范围
$weekRangeSundayStart = getWeekRange(false, 'America/New_York');
echo "以周日为起始的本周范围 (美东时区)：";
echo " 起始日期: " . $weekRangeSundayStart['start']->format('Y-m-d H:i:s') . "";
echo " 结束日期: " . $weekRangeSundayStart['end']->format('Y-m-d H:i:s') . "";
// 进一步操作：获取下周一的日期
$nextMonday = clone $weekRangeMondayStart['start'];
$nextMonday->modify('+7 days');
echo "下周一的日期: " . $nextMonday->format('Y-m-d') . "";
?>

这个 `getWeekRange` 函数具备以下优点：
参数化：通过 `$startOnMonday` 控制周的起始日。
时区支持：允许传入自定义时区，增强灵活性。
返回 `DateTime` 对象：而不是简单的字符串，这使得调用者可以进一步对日期进行各种操作（如格式化、加减天数、比较等），保持了数据类型的一致性和功能性。
时间重置：将起始日的时间设置为 `00:00:00`，结束日的时间设置为 `23:59:59`，确保获取的是完整的一天范围，这对于数据库查询、统计等场景非常重要。

六、常见问题与注意事项

1. 夏令时（DST）影响

`DateTime` 对象和 `strtotime()` 在处理夏令时时通常是智能的，它们会自动调整。但是，如果你在进行精确的时间跨度计算（如秒数差），并且跨越了夏令时调整点，需要特别注意。对于本周的起始和结束日期这种跨度计算，影响通常不大，因为它们关注的是日期而非精确秒数。

2. 性能考量

对于大多数Web应用而言，日期时间操作的性能开销通常不是瓶颈。`DateTime` 对象虽然功能强大，但在非常密集的循环中可能会比简单的 `date()` 和 `strtotime()` 组合略慢。但在实际开发中，除非有极端性能要求，否则 `DateTime` 的可读性和鲁棒性优势远大于其微小的性能差异。

3. `strtotime()` 的解析弹性

`strtotime()` 非常灵活，但也可能因为其过于“智能”而产生意外行为，特别是在处理不明确的日期字符串时。例如，`strtotime('this week Sunday')` 在某些情况下可能与 `strtotime('Sunday this week')` 行为稍有不同。因此，在使用时尽量采用明确的表达，或优先使用 `DateTime`。

4. 跨年问题

`DateTime` 和 `strtotime()` 都能正确处理跨年问题，无论是获取本周的起始/结束日期，还是进行日期加减，它们都会自动调整年份。

七、总结

获取PHP当前周的起始和结束日期是一个基础但重要的需求。我们介绍了两种主要方法：
`strtotime()` 与 `date()`：简洁快速，适合简单场景。但需要注意时区和周起始日的约定。
`DateTime` 对象：推荐使用，提供了强大的面向对象功能、更好的可读性、可维护性和鲁棒性，尤其是在处理时区和复杂日期逻辑时表现出色。

最佳实践是将其封装为一个可复用的函数，返回 `DateTime` 对象，并明确处理时区和周起始日的约定。通过遵循这些指南，你将能够自信地在PHP应用程序中处理各种日期时间需求。

2025-11-04

上一篇：PHP网站文件探索与安全分析：从表象到本质的攻防视角

下一篇：PHP 多维数组：高效获取与输出指定行数据的全面指南