如何在Laravel中使用Carbon包设置隔周工作日休息？

1. 设定基准起始周 #

先确定一个基准日期，用来区分“工作周”和“休息周”。比如选某一个明确的工作周周一作为起始点，示例中用2024-01-01（周一）。

2. 编写核心判断方法 #

通过Carbon计算目标日期与基准周的间隔，判断是否属于休息的工作日：

use Carbon\Carbon;

function isRestWorkday(Carbon $date): bool
{
    // 基准日期：第一个工作周的周一
    $baseDate = Carbon::parse('2024-01-01')->startOfWeek();
    // 计算目标日期所在周与基准周的间隔周数
    $weekDiff = $date->startOfWeek()->diffInWeeks($baseDate, false);
    
    // 先判断是否为工作日（周一至周五）
    $isWorkday = $date->isWeekday();
    
    // 规则：间隔周数为奇数时，工作日休息；偶数周正常上班
    // 可根据实际需求调换奇偶判断逻辑
    return $isWorkday && ($weekDiff % 2 !== 0);
}

3. 集成到自定义日历逻辑 #

在生成日历数据时，对每个日期调用上述方法标记状态：

// 示例：生成指定月份的日历数据
$targetMonth = Carbon::parse('2024-05');
$totalDays = $targetMonth->daysInMonth;

$calendarData = [];
for ($day = 1; $day <= $totalDays; $day++) {
    $currentDate = Carbon::parse("{$targetMonth->year}-{$targetMonth->month}-{$day}");
    $calendarData[] = [
        'date' => $currentDate->toDateString(),
        'is_rest_workday' => isRestWorkday($currentDate),
        'is_weekend' => $currentDate->isWeekend(),
    ];
}

4. 灵活调整规则 #

• 如果你的起始基准周不同，直接修改$baseDate的取值即可。
• 若需要“奇数周工作、偶数周休息”，把判断条件改为$weekDiff % 2 === 0。

5. 跨年度周数兼容 #

Carbon的diffInWeeks方法会自动处理跨年度的周数计算，无需额外处理跨年导致的间隔误差。

内容的提问来源于stack exchange，提问作者Sadar khan