如何在Laravel中修改日期格式并转换为数据库兼容存储格式

原有实现的正确性判断 #

原有代码在前端输入格式固定、无异常的场景下可以正常运行，但存在多个明显隐患，不推荐直接用于生产环境：

• 缺失输入校验：如果$request->date_range为空、或者不符合起始时间 - 结束时间的分隔格式，拆分函数会返回空值，后续Carbon::parse会直接抛出错误
• 自动解析风险：Carbon::parse依赖自动识别日期格式，若前端传入格式发生变动（比如日月顺序调换、分隔符变化），很容易出现解析错误，比如把06/23/2021识别成2021年23月6日直接报错，或者把03/04/2021的日月搞反
• 时区处理缺失：如果前端和服务端时区不一致，解析出来的时间会出现偏差
• 代码冗余：相同的转换逻辑重复写两次，后续调整格式需要修改多处

原有实现代码参考：

// 拆分日期区间字符串
$from_date_time = get_before_of_string(' - ', $request->date_range); // 示例输入：06/23/2021 12:00 上午
$to_date_time = get_after_of_string(' - ', $request->date_range); // 示例输入：06/23/2021 12:00 上午

// 转换为数据库兼容格式
$from_date_time = Carbon::parse($from_date_time)->format('Y-m-d H:i:s'); // 输出：2021-06-23 00:00:00
$to_date_time = Carbon::parse($to_date_time)->format('Y-m-d H:i:s'); // 输出：2021-06-23 00:00:00

推荐的最优实现方案 #

1. 验证+指定格式解析（前端传入日期区间首选） #

先做输入合法性校验，再用Carbon::createFromFormat指定输入格式解析，彻底避免自动识别的误差，同时主动处理时区：

// 第一步：请求参数校验（可写在FormRequest类或控制器验证逻辑中）
$validated = $request->validate([
    'date_range' => 'required|regex:/^\d{2}\/\d{2}\/\d{4} \d{2}:\d{2} (上午|下午) - \d{2}\/\d{2}\/\d{4} \d{2}:\d{2} (上午|下午)$/',
]);

// 第二步：拆分、指定格式解析、时区转换
list($fromStr, $toStr) = explode(' - ', $validated['date_range']);
// 输入格式对应：月/日/年 12小时制时:分 上午/下午
$inputFormat = 'm/d/Y h:i A';
// 解析时指定前端时区，转换为服务端配置的时区
$fromDateTime = Carbon::createFromFormat($inputFormat, $fromStr, 'Asia/Shanghai')
    ->setTimezone(config('app.timezone'))
    ->format('Y-m-d H:i:s');
$toDateTime = Carbon::createFromFormat($inputFormat, $toStr, 'Asia/Shanghai')
    ->setTimezone(config('app.timezone'))
    ->format('Y-m-d H:i:s');

2. 模型属性自动转换（单日期字段场景首选） #

如果是单个日期字段传入，不需要手动写转换逻辑，直接在Eloquent模型中定义$casts属性，Laravel会自动完成格式转换：

// 在对应模型中定义日期字段转换规则
protected $casts = [
    'published_at' => 'datetime:Y-m-d H:i:s',
    'start_time' => 'datetime:Y-m-d H:i:s',
    'end_time' => 'datetime:Y-m-d H:i:s',
];

// 控制器中直接赋值即可，Laravel自动转换为数据库兼容格式
$article->published_at = $request->input('published_at');
$article->save();

3. 全局中间件统一转换 #

如果前端所有传入的日期都是固定格式，可以写全局中间件，在请求进入控制器之前就完成所有日期字段的格式转换，避免重复代码：

// 中间件handle方法示例
public function handle(Request $request, Closure $next)
{
    // 配置需要统一转换的日期字段
    $dateFields = ['birth_date', 'order_time', 'sign_time'];
    $inputFormat = 'm/d/Y';
    foreach ($dateFields as $field) {
        if ($request->filled($field)) {
            $request->merge([
                $field => Carbon::createFromFormat($inputFormat, $request->input($field))
                    ->format('Y-m-d')
            ]);
        }
    }
    return $next($request);
}

4. 查询Scope封装复用 #

如果经常需要处理日期区间查询，可以把转换逻辑封装到模型的查询Scope中，复用性更高：

// 模型中定义日期区间查询Scope
public function scopeWhereDateBetween($query, string $dateRange, string $field = 'created_at')
{
    list($fromStr, $toStr) = explode(' - ', $dateRange);
    $inputFormat = 'm/d/Y h:i A';
    $from = Carbon::createFromFormat($inputFormat, $fromStr)->startOfDay();
    $to = Carbon::createFromFormat($inputFormat, $toStr)->endOfDay();
    return $query->whereBetween($field, [$from, $to]);
}

// 控制器中直接调用即可
$orders = Order::whereDateBetween($request->date_range)->get();

内容的提问来源于stack exchange，提问作者Md. Sakir Ahmed