如何使用Laravel Carbon计算贷款到期还款日

已知贷款起始日期为2020年1月1日，期限2年5个月，用Laravel Carbon计算到期日的方案如下：

核心思路 #

利用Carbon提供的日期增减方法，直接对起始日期添加对应年限和月数即可，Carbon会自动处理日期的边界情况（比如月末、闰年等）。

代码实现 #

// 引入Carbon类
use Carbon\Carbon;

// 初始化贷款起始日期
$startDate = Carbon::create(2020, 1, 1);

// 计算到期日：使用copy()避免修改原日期实例
// 方法1：分别添加年和月
$maturityDate = $startDate->copy()->addYears(2)->addMonths(5);

// 方法2：转换为总月数一次性添加（2年=24个月，合计29个月）
// $maturityDate = $startDate->copy()->addMonths(29);

// 格式化输出到期日期
echo $maturityDate->format('Y-m-d'); // 输出：2022-06-01

关键说明 #

• 使用copy()方法是因为Carbon对象默认是**可变（mutable）**的，直接调用addYears/addMonths会修改原$startDate实例，使用copy()可以创建副本进行操作，保留原始日期数据。
• Carbon会自动处理特殊日期场景：比如如果起始日是2020年2月29日（闰年），添加1年后会自动转为2021年2月28日，符合实际业务逻辑。

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