PHP中利用Carbon库高效获取指定月份的周起始与结束日期

composer require nesbot/carbon

<?php

require 'vendor/autoload.php'; // 确保Composer自动加载文件已引入

use Carbon\Carbon;

// 创建一个Carbon实例，例如指定日期 2014年5月30日
$date = Carbon::create(2014, 5, 30, 0, 0, 0);

echo "原始日期: " . $date->format('Y-m-d H:i:s') . PHP_EOL;

// 获取月份的第一天
$firstDayOfMonth = $date->firstOfMonth();
echo "月份第一天: " . $firstDayOfMonth->format('Y-m-d H:i:s') . PHP_EOL; // 输出: 2014-05-01 00:00:00

// 获取月份的最后一天
$lastDayOfMonth = $date->lastOfMonth();
echo "月份最后一天: " . $lastDayOfMonth->format('Y-m-d H:i:s') . PHP_EOL;  // 输出: 2014-05-31 00:00:00

// 您还可以指定月份的第一天是星期几
// 例如，获取5月份的第一个星期一
$firstMondayOfMonth = $date->firstOfMonth(Carbon::MONDAY);
echo "月份第一个星期一: " . $firstMondayOfMonth->format('Y-m-d H:i:s') . PHP_EOL; // 输出: 2014-05-05 00:00:00

// 获取5月份的最后一个星期二
$lastTuesdayOfMonth = $date->lastOfMonth(Carbon::TUESDAY);
echo "月份最后一个星期二: " . $lastTuesdayOfMonth->format('Y-m-d H:i:s') . PHP_EOL; // 输出: 2014-05-27 00:00:00

// 获取月份的第N个特定星期几
// 例如，获取5月份的第二个星期六
$secondSaturdayOfMonth = $date->nthOfMonth(2, Carbon::SATURDAY);
echo "月份第二个星期六: " . $secondSaturdayOfMonth->format('Y-m-d H:i:s') . PHP_EOL; // 输出: 2014-05-10 00:00:00

<?php

require 'vendor/autoload.php';

use Carbon\Carbon;

/**
 * 获取指定月份中所有周的起始和结束日期。
 *
 * @param int $year 年份
 * @param int $month 月份 (1-12)
 * @return array 包含周起始和结束日期的数组
 */
function getWeeksInMonth(int $year, int $month): array
{
    $weeks = [];
    // 创建该月份的第一天，并将其时间设置为00:00:00
    $firstDayOfMonth = Carbon::createFromDate($year, $month, 1)->startOfDay();
    // 获取该月份的最后一天，并将其时间设置为23:59:59
    $lastDayOfMonth = $firstDayOfMonth->copy()->endOfMonth()->endOfDay();

    // 从月份的第一天开始迭代
    $currentDay = $firstDayOfMonth->copy();

    while ($currentDay->lte($lastDayOfMonth)) {
        // 获取当前日期所在周的起始日和结束日
        // 默认情况下，Carbon的startOfWeek()和endOfWeek()取决于配置，通常是周一到周日。
        // 您可以通过 Carbon::setWeekStartsAt() 和 Carbon::setWeekEndsAt() 进行配置。
        $startOfWeek = $currentDay->copy()->startOfWeek();
        $endOfWeek = $currentDay->copy()->endOfWeek();

        // 调整周的起始和结束日期，确保它们不会超出当前月份的范围
        // 如果周的起始日期在月份之前，则将其调整为月份的第一天
        $weekStart = $startOfWeek->lt($firstDayOfMonth) ? $firstDayOfMonth : $startOfWeek;
        // 如果周的结束日期在月份之后，则将其调整为月份的最后一天
        $weekEnd = $endOfWeek->gt($lastDayOfMonth) ? $lastDayOfMonth : $endOfWeek;

        // 只有当计算出的周至少有一天在当前月份内时才添加
        if ($weekStart->lte($lastDayOfMonth) && $weekEnd->gte($firstDayOfMonth)) {
             $weeks[] = [
                'start' => $weekStart->format('Y-m-d'),
                'end' => $weekEnd->format('Y-m-d'),
            ];
        }

        // 移动到下一周的开始（即当前周结束后的第二天）
        $currentDay = $endOfWeek->addDay();
    }

    return $weeks;
}

// 示例用法：获取2024年1月份的所有周
echo "=== 2024年1月份的所有周 ===" . PHP_EOL;
$januaryWeeks = getWeeksInMonth(2024, 1);
foreach ($januaryWeeks as $week) {
    echo "周起始: " . $week['start'] . ", 周结束: " . $week['end'] . PHP_EOL;
}
echo PHP_EOL;

// 示例用法：处理多个月份（例如：2024年1月、2月、3月）
$selectedMonths = [
    ['year' => 2024, 'month' => 1], // January
    ['year' => 2024, 'month' => 2], // February
    ['year' => 2024, 'month' => 3], // March
];

echo "=== 2024年1月、2月、3月份的所有周 ===" . PHP_EOL;
$allWeeksAcrossMonths = [];
foreach ($selectedMonths as $monthData) {
    $monthWeeks = getWeeksInMonth($monthData['year'], $monthData['month']);
    foreach ($monthWeeks as $week) {
        echo "月份: {$monthData['month']}, 周起始: " . $week['start'] . ", 周结束: " . $week['end'] . PHP_EOL;
    }
    $allWeeksAcrossMonths = array_merge($allWeeksAcrossMonths, $monthWeeks);
}
// print_r($allWeeksAcrossMonths); // 如果需要查看合并后的所有周数据