You need to enable JavaScript to run this app. 如何转换PHP日期范围格式并实现适配MySQL的Laravel日期范围搜索
优惠活动
大模型
产品
解决方案
定价
更多

如何转换PHP日期范围格式并实现适配MySQL的Laravel日期范围搜索

日期范围格式转换与Laravel查询实现

第一步:将输入格式转换为数据库兼容的标准时间

你拿到的前端输入是22 Mar, 2021 - 22 Apr, 2021这类带英文月份缩写的范围字符串,不用手写逐字符切分的解析逻辑,用Laravel自带的Carbon扩展就能稳定处理,核心操作逻辑很直接:

  • 先移除输入首尾的多余空格,按固定分隔符-拆分出开始、结束两个独立日期字符串
  • 解析完的日期必须给开始时间补到当天00:00:00、结束时间补到当天23:59:59,如果直接用默认解析的零点时间,会漏掉结束日期当天的全量数据
  • 如果项目改了Carbon的默认语言配置,要强制指定解析时用英文语言环境,避免Mar、Apr这类月份缩写解析报错

对应的转换代码:

use Carbon\Carbon;

// 获取前端传入的原始日期范围
$rawDateRange = trim(request()->input('date_range', ''));

// 拆分得到开始、结束日期的原始字符串
[$startRaw, $endRaw] = explode(' - ', $rawDateRange);

// 解析为Carbon实例,强制用英文环境避免多语言干扰
$startDate = Carbon::createFromFormat('j M, Y', trim($startRaw), 'en')->startOfDay();
$endDate = Carbon::createFromFormat('j M, Y', trim($endRaw), 'en')->endOfDay();

这里的格式串j M, Y是专门适配你拿到的输入格式的:j代表不补零的日期数字(兼容2 Mar和02 Mar两种写法),M代表三字母英文月份缩写,Y代表四位年份。

第二步:编写Laravel适配的日期范围查询

数据库里的created_at是标准datetime格式,你已经有了转换好的时间实例,直接用查询构造器的whereBetween就能实现范围匹配,不需要额外写复杂的SQL语句:

// 以查询订单数据为例
$orderList = \App\Models\Order::query()
    // 只有当用户传入了日期范围时才追加查询条件
    ->when($rawDateRange, function ($query) use ($startDate, $endDate) {
        $query->whereBetween('created_at', [
            // 显式把Carbon转成数据库兼容的Y-m-d H:i:s格式字符串
            $startDate->toDateTimeString(),
            $endDate->toDateTimeString()
        ]);
    })
    ->get();

常见踩坑提醒

  • 不要直接把Carbon实例丢进查询参数,显式转成时间字符串可以避免时区偏移导致的范围匹配错误
  • 如果数据库和应用配置了不同时区,要在解析日期时手动指定和数据库一致的时区,不然会出现差8小时之类的匹配偏差
  • 最好在请求入口加个简单的格式校验,避免用户乱传非法字符串导致Carbon解析报错:
// 简单的输入格式校验
request()->validate([
    'date_range' => [
        'nullable',
        'regex:/^\d{1,2} [A-Z][a-z]{2}, \d{4} - \d{1,2} [A-Z][a-z]{2}, \d{4}$/'
    ]
]);

内容的提问来源于stack exchange,提问作者Chinnu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 17:27:04