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

composer require nesbot/carbon

use Carbon\Carbon;

$dateInMonth = Carbon::create(2014, 5, 30, 0, 0, 0);

// 获取该月的第一天
echo $dateInMonth->firstOfMonth(); // 输出 2014-05-01 00:00:00

// 获取该月的最后一天
echo $dateInMonth->lastOfMonth();  // 输出 2014-05-31 00:00:00

// 获取该月第一个星期一
echo $dateInMonth->firstOfMonth(Carbon::MONDAY); // 输出 2014-05-05 00:00:00

// 获取该月最后一个星期二
echo $dateInMonth->lastOfMonth(Carbon::TUESDAY);  // 输出 2014-05-27 00:00:00

// 获取该月第二个星期六
echo $dateInMonth->nthOfMonth(2, Carbon::SATURDAY); // 输出 2014-05-10 00:00:00

use Carbon\Carbon;

/**
 * 获取指定日期所在周的起始（周一）和结束（周日）日期。
 *
 * @param string $dateString 任意日期字符串，如 '2021-12-01'
 * @return array 包含 'week_start' 和 'week_end' 键的数组
 */
function getWeekStartAndEndDate(string $dateString): array
{
    $carbonDate = Carbon::parse($dateString);

    // 获取当前日期所在周的周一
    $weekStart = $carbonDate->startOfWeek(Carbon::MONDAY);

    // 获取当前日期所在周的周日
    $weekEnd = $carbonDate->endOfWeek(Carbon::SUNDAY);

    return [
        'week_start' => $weekStart->format('Y-m-d'),
        'week_end' => $weekEnd->format('Y-m-d')
    ];
}

// 示例用法
$dateToProcess = '2021-12-01'; // 2021年12月1日是星期三
$weekDates = getWeekStartAndEndDate($dateToProcess);

echo "日期 {$dateToProcess} 所在周的起始日期是: " . $weekDates['week_start'] . "\n";
echo "日期 {$dateToProcess} 所在周的结束日期是: " . $weekDates['week_end'] . "\n";

// 输出：
// 日期 2021-12-01 所在周的起始日期是: 2021-11-29
// 日期 2021-12-01 所在周的结束日期是: 2021-12-05

use Carbon\Carbon;

/**
 * 获取指定月份中所有周的起始和结束日期。
 *
 * @param int $year 年份，例如 2023
 * @param int $month 月份，例如 12
 * @return array 包含该月份所有周信息的数组
 */
function getAllWeeksInMonth(int $year, int $month): array
{
    $weeksInMonth = [];

    // 获取该月的第一天
    $firstDayOfMonth = Carbon::create($year, $month, 1)->startOfDay();
    // 获取该月的最后一天
    $lastDayOfMonth = Carbon::create($year, $month, 1)->endOfMonth()->endOfDay();

    // 从该月的第一天开始，找到它所在周的周一
    $currentWeekStart = $firstDayOfMonth->copy()->startOfWeek(Carbon::MONDAY);

    // 循环直到当前周的开始日期超过该月的最后一天
    while ($currentWeekStart->lessThanOrEqualTo($lastDayOfMonth)) {
        // 计算当前周的结束日期
        $currentWeekEnd = $currentWeekStart->copy()->endOfWeek(Carbon::SUNDAY);

        // 确保周结束日期不超过该月的最后一天，如果超出则取该月最后一天
        // 实际上，我们通常关心的是完整的自然周，所以这里不需要特别限制
        // 如果需要限制在月内，则需要额外的条件判断，但通常周是跨月的

        $weeksInMonth[] = [
            'week_start' => $currentWeekStart->format('Y-m-d'),
            'week_end' => $currentWeekEnd->format('Y-m-d')
        ];

        // 移动到下一周的开始日期
        $currentWeekStart->addWeek()->startOfWeek(Carbon::MONDAY);
    }

    return $weeksInMonth;
}

// 示例：获取 2023 年 12 月的所有周
$weeksOfDecember = getAllWeeksInMonth(2023, 12);

echo "2023年12月的所有周：\n";
foreach ($weeksOfDecember as $week) {
    echo "  周起始: " . $week['week_start'] . " - 周结束: " . $week['week_end'] . "\n";
}

// 示例：获取指定月份列表的所有周
$selectedMonths = [
    Carbon::create(2024, 1, 1), // 2024年1月
    Carbon::create(2024, 2, 1), // 2024年2月
    Carbon::create(2024, 3, 1), // 2024年3月
];

echo "\n选定月份的所有周：\n";
foreach ($selectedMonths as $monthCarbon) {
    echo "--- " . $monthCarbon->format('Y年m月') . " ---\n";
    $weeks = getAllWeeksInMonth($monthCarbon->year, $monthCarbon->month);
    foreach ($weeks as $week) {
        echo "  周起始: " . $week['week_start'] . " - 周结束: " . $week['week_end'] . "\n";
    }
}