Laravel Carbon解析m/Y格式日期出现偏差的问题排查与解决

问题原因 #

使用Carbon::createFromFormat('m/Y', $dateString)时，Carbon会默认用当前系统日期的日部分补全日期。如果当前日期的日数大于目标月份的最大天数（比如测试时当前是31号，而2月只有28/29天），Carbon会自动将日期进位到下一个月，这就是输入"02/2024"却得到"2023-03-01"的核心原因。

解决方案 #

以下几种方式可彻底避免这个问题：

方式1：显式指定日期为每月1号 #

直接在创建日期对象后强制设置日为1，或在格式中补充日占位符并传入固定值：

// 方法A：创建后设置日为1
$date = Carbon::createFromFormat('m/Y', $dateString)->day(1)->startOfMonth();

// 方法B：用完整格式拼接固定日
$date = Carbon::createFromFormat('d/m/Y', "01/$dateString")->startOfMonth();

方式2：使用Carbon::parse简化处理 #

parse方法可直接识别"m/Y"格式，且默认将日设为1，无需担心日期进位：

$date = Carbon::parse($dateString)->startOfMonth();

方式3：手动拆分构建日期 #

拆分输入的月份和年份，手动传入日为1构建日期：

list($month, $year) = explode('/', $dateString);
$date = Carbon::create($year, $month, 1)->startOfMonth();

优化后的完整代码 #

推荐采用方式2的简洁写法，同时保留原有校验逻辑：

$dateString = $request->d;

if ($dateString && preg_match('/^\d{2}\/\d{4}$/', $dateString)) {
    $date = Carbon::parse($dateString)->startOfMonth();
} else {
    $date = Carbon::now()->startOfMonth();
}

$formattedDate = $date->format('m/Y');

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