PHP Carbon：生成未来指定星期几的日期序列

use Carbon\Carbon;

// 获取当前时间
$now = Carbon::now();
echo "当前日期: " . $now->toDateString() . "\n";

// 获取下一个星期三的日期
$nextWednesday = $now->next('Wednesday');
echo "下一个星期三: " . $nextWednesday->toDateString() . "\n";

use Carbon\Carbon;

/**
 * 生成未来指定星期几的日期序列
 *
 * @param string $startDateStr 起始日期字符串
 * @param string|int $dayOfWeek 目标星期几（英文名称或Carbon数字表示）
 * @param int $count 要生成的日期数量
 * @return array 日期字符串数组
 */
function generateFutureWeekdays(string $startDateStr, $dayOfWeek, int $count): array
{
    $dates = [];
    $currentDate = Carbon::parse($startDateStr);

    // 获取第一个目标星期几的日期
    $firstTargetDate = $currentDate->next($dayOfWeek);

    for ($i = 0; $i < $count; $i++) {
        // 在第一个目标日期的基础上，逐周增加
        $dates[] = $firstTargetDate->copy()->addWeeks($i)->toDateString();
    }

    return $dates;
}

// 示例用法：从2021年12月22日开始，获取未来3个星期三
$startDate = '2021-12-22';
$targetDay = 'Wednesday';
$numberOfDates = 3;

$resultDates = generateFutureWeekdays($startDate, $targetDay, $numberOfDates);

echo "从 {$startDate} 开始的未来 {$numberOfDates} 个 {$targetDay}：\n";
foreach ($resultDates as $date) {
    echo $date . "\n";
}
/* 预期输出 (基于2021-12-22为周三):
2021-12-29
2022-01-05
2022-01-12
*/

// 如果起始日期是2021-12-21 (周二)
$startDate2 = '2021-12-21';
$resultDates2 = generateFutureWeekdays($startDate2, $targetDay, $numberOfDates);
echo "\n从 {$startDate2} 开始的未来 {$numberOfDates} 个 {$targetDay}：\n";
foreach ($resultDates2 as $date) {
    echo $date . "\n";
}
/* 预期输出 (基于2021-12-21为周二):
2021-12-22
2021-12-29
2022-01-05
*/

use Carbon\Carbon;

/**
 * 将自定义的星期几数字映射转换为 Carbon 兼容的数字
 *
 * @param int $customDayOfWeek 自定义星期几数字 (0=周六, 1=周日, ..., 6=周五)
 * @return int Carbon 兼容的星期几数字 (0=周日, 1=周一, ..., 6=周六)
 */
function mapCustomDayToCarbon(int $customDayOfWeek): int
{
    // 假设自定义映射为 0=周六, 1=周日, ..., 6=周五
    // Carbon 映射为 0=周日, 1=周一, ..., 6=周六
    // 我们可以通过 (customDayOfWeek + 6) % 7 进行转换
    return ($customDayOfWeek + 6) % 7;
}

// 示例：使用数字形式的星期几（假设 '4' 代表星期三）
$startDate = '2021-12-22'; // 星期三
$customDayNumber = 4; // 假设 4 代表星期三 (波斯语映射)
$numberOfDates = 3;

// 转换为 Carbon 兼容的星期几数字
$carbonDayNumber = mapCustomDayToCarbon($customDayNumber);

$resultDates = generateFutureWeekdays($startDate, $carbonDayNumber, $numberOfDates);

echo "\n从 {$startDate} 开始的未来 {$numberOfDates} 个（数字 {$customDayNumber} 对应）日期：\n";
foreach ($resultDates as $date) {
    echo $date . "\n";
}
/* 预期输出:
2021-12-29
2022-01-05
2022-01-12
*/