PHP 日期处理：高效获取月份内所有周的范围 (Carbon 实践)

composer require nesbot/carbon

require 'vendor/autoload.php';

use Carbon\Carbon;

<?php

require 'vendor/autoload.php';

use Carbon\Carbon;

/**
 * 获取指定年份和月份中所有周的起始和结束日期。
 *
 * @param array $months 要处理的月份列表 (例如: ['Jan', 'Feb', 'Mar'] 或 [1, 2, 3])
 * @param int $year 目标年份
 * @param string $weekStartsOn 周的起始日，默认为 Carbon::MONDAY (周一)
 * @return array 包含每个月份及其对应周起始和结束日期的关联数组
 */
function getWeeksInMonths(array $months, int $year, string $weekStartsOn = Carbon::MONDAY): array
{
    $result = [];

    foreach ($months as $monthInput) {
        // 尝试解析月份输入，创建该月的第一天
        try {
            // 优先尝试按月份名称解析，并设置年份
            $firstDayOfMonth = Carbon::parse($monthInput . ' ' . $year)->startOfMonth();
        } catch (\Exception $e) {
            // 如果月份名称解析失败，尝试按月份数字解析
            if (is_numeric($monthInput)) {
                $firstDayOfMonth = Carbon::create($year, (int)$monthInput, 1)->startOfMonth();
            } else {
                // 如果无法解析，跳过当前月份或抛出错误
                error_log("无法解析月份输入: " . $monthInput);
                continue;
            }
        }

        $endOfMonth = $firstDayOfMonth->copy()->endOfMonth();
        $monthKey = $firstDayOfMonth->format('Y-M'); // 用于结果数组的键名，例如 "2024-Jan"

        $monthWeeks = [];

        // 从该月第一天所属的周的起始日期开始
        // 使用 copy() 避免修改原始 $firstDayOfMonth 对象
        $currentWeekStart = $firstDayOfMonth->copy()->startOfWeek($weekStartsOn);

        // 循环直到当前周的起始日期超过该月最后一天所属的周的结束日期
        // 这样可以确保包含跨越月份边界的最后一周
        while ($currentWeekStart->lessThanOrEqualTo($endOfMonth->copy()->endOfWeek($weekStartsOn))) {
            $weekEnd = $currentWeekStart->copy()->endOfWeek($weekStartsOn);

            $monthWeeks[] = [
                'week_start' => $currentWeekStart->toDateString(),
                'week_end' => $weekEnd->toDateString(),
            ];

            // 移动到下一周的起始日期
            $currentWeekStart->addWeek();
        }
        $result[$monthKey] = $monthWeeks;
    }

    return $result;
}

<?php

require 'vendor/autoload.php';

use Carbon\Carbon;

// 引入上面定义的 getWeeksInMonths 函数
// (为简洁起见，此处省略函数定义，请确保其已包含在您的文件中)

/**
 * 获取指定年份和月份中所有周的起始和结束日期。
 *
 * @param array $months 要处理的月份列表 (例如: ['Jan', 'Feb', 'Mar'] 或 [1, 2, 3])
 * @param int $year 目标年份
 * @param string $weekStartsOn 周的起始日，默认为 Carbon::MONDAY (周一)
 * @return array 包含每个月份及其对应周起始和结束日期的关联数组
 */
function getWeeksInMonths(array $months, int $year, string $weekStartsOn = Carbon::MONDAY): array
{
    $result = [];

    foreach ($months as $monthInput) {
        try {
            $firstDayOfMonth = Carbon::parse($monthInput . ' ' . $year)->startOfMonth();
        } catch (\Exception $e) {
            if (is_numeric($monthInput)) {
                $firstDayOfMonth = Carbon::create($year, (int)$monthInput, 1)->startOfMonth();
            } else {
                error_log("无法解析月份输入: " . $monthInput);
                continue;
            }
        }

        $endOfMonth = $firstDayOfMonth->copy()->endOfMonth();
        $monthKey = $firstDayOfMonth->format('Y-M');

        $monthWeeks = [];
        $currentWeekStart = $firstDayOfMonth->copy()->startOfWeek($weekStartsOn);

        while ($currentWeekStart->lessThanOrEqualTo($endOfMonth->copy()->endOfWeek($weekStartsOn))) {
            $weekEnd = $currentWeekStart->copy()->endOfWeek($weekStartsOn);

            $monthWeeks[] = [
                'week_start' => $currentWeekStart->toDateString(),
                'week_end' => $weekEnd->toDateString(),
            ];

            $currentWeekStart->addWeek();
        }
        $result[$monthKey] = $monthWeeks;
    }

    return $result;
}

// 示例用法：
$selectedMonths =