如何使用PHP Carbon获取每月指定日期的下一次出现（无溢出）

Carbon目前没有专门针对该场景的内置函数，但可以通过现有方法简洁实现你的需求：找到指定日期的下一次出现，若当月无该日期则取当月最后一天，且不会溢出到下个月。

核心实现代码 #

function nextSpecifiedDay(\Carbon\Carbon $startDate, int $targetDay): \Carbon\Carbon
{
    $candidate = $startDate->copy()->setDay($targetDay);
    
    // 若候选日期早于起始日期，说明当前月的目标日已过，需定位到下一个月的目标日
    if ($candidate->lessThan($startDate)) {
        $candidate->addMonthNoOverflow()->setDay($targetDay);
    }
    
    // 自动处理溢出：若目标日超出当月天数，取当月最后一天
    return $candidate->min($candidate->copy()->endOfMonth());
}

代码说明 #

1. 生成候选日期：基于起始日期复制实例，直接设置为目标日
2. 判断月份偏移：如果候选日期早于起始日期，说明当前月的目标日已过，自动跳转到下一个月
3. 处理溢出场景：通过min()方法对比候选日期与当月最后一天，自动取较小值，避免31号这类日期在小月中溢出

简化链式调用版本 #

如果追求更简洁的写法，可使用一行链式调用实现：

$nextDate = $startDate->copy()
    ->addMonthNoOverflow($startDate->day > $targetDay ? 1 : 0)
    ->setDay($targetDay)
    ->min($startDate->copy()->endOfMonth());

示例用法 #

// 从2024-02-15找下一个30号，2月无30号，返回2024-02-29
echo nextSpecifiedDay(Carbon::parse('2024-02-15'), 30)->toDateString();

// 从2024-03-15找下一个30号，返回2024-03-30
echo nextSpecifiedDay(Carbon::parse('2024-03-15'), 30)->toDateString();

// 从2024-03-31找下一个30号，当月30号已过，返回2024-04-30
echo nextSpecifiedDay(Carbon::parse('2024-03-31'), 30)->toDateString();

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