laravel 12 中按日期分组查询每日数据应优先使用数据库原生日期函数(如 mysql 的 date()、postgresql 的 created_at::date)配合 db::raw() 和 groupby,兼顾性能与跨库兼容性;小数据量可选集合 groupby(todatestring()),但不推荐生产环境。

在 Laravel 12 中按日期分组查询每日数据,核心是将时间字段(如 created_at)截取到「年月日」级别,再配合 groupBy 使用。由于 MySQL、PostgreSQL 和 SQLite 对日期函数支持不同,Laravel 提供了数据库无关的写法(推荐),也支持原生函数(需注意兼容性)。
✅ 推荐:用 DATE() 函数(MySQL/SQLite)或 DATE_TRUNC()(PostgreSQL)
Laravel 12 的查询构建器支持跨数据库的日期截取方式,最稳妥的是使用 DB::raw() 配合对应数据库函数,并在模型中统一处理:
- MySQL / SQLite:
DATE(created_at) - PostgreSQL:
DATE_TRUNC('day', created_at)或created_at::date
示例(适配 MySQL,默认场景):
$dailyData = Order::select(
DB::raw('DATE(created_at) as date'),
DB::raw('COUNT(*) as count'),
DB::raw('SUM(total) as total_amount')
)
->whereBetween('created_at', ['2024-01-01', '2024-01-31'])
->groupBy(DB::raw('DATE(created_at)'))
->orderBy('date')
->get();
✅ 更优雅:用 castDate() + toDateString()(仅适用于内存后处理,不推荐大数据量)
如果数据量不大,也可先查出记录,再用 Laravel 集合按日期分组:
$orders = Order::whereBetween('created_at', ['2024-01-01', '2024-01-31'])->get();
$dailyData = $orders->groupBy(function ($item) {
return $item->created_at->toDateString(); // 转为 'Y-m-d' 字符串
})->map(function ($group) {
return [
'count' => $group->count(),
'total_amount' => $group->sum('total'),
];
});
⚠️ 注意:该方式在 PHP 层分组,不走数据库聚合,数据量大时性能差,仅适合小范围补救或调试。
✅ 兼容多数据库:用 Illuminate\Support\Facades\DB 动态判断
若项目需同时支持 MySQL 和 PostgreSQL,可封装一个辅助方法:
use Illuminate\Support\Facades\DB;
function dailyGroupColumn(): string
{
$driver = DB::getDriverName();
return match($driver) {
'mysql', 'sqlite' => 'DATE(created_at)',
'pgsql' => "created_at::date",
default => 'DATE(created_at)',
};
}
// 使用
$dailyData = Order::select(
DB::raw(dailyGroupColumn() . ' as date'),
DB::raw('COUNT(*) as count')
)
->whereDate('created_at', '>=', '2024-01-01')
->groupBy(DB::raw(dailyGroupColumn()))
->orderBy('date')
->get();
? 小技巧:用 whereDate() 替代 whereBetween() 简化条件
当只需按「天」过滤(而非精确到时分秒),直接用 Laravel 内置的 whereDate() 更清晰:
->whereDate('created_at', '>=', '2024-01-01')
->whereDate('created_at', '
<p>它会自动转换为各数据库对应的日期比较语句(如 MySQL 的 <code>DATE(created_at) >= '2024-01-01'</code>),安全且可读性强。</p>
<p>不复杂但容易忽略:确保 <code>created_at</code> 字段有索引(尤其是组合索引如 <code>(created_at)</code> 或 <code>(created_at, status)</code>),否则每日分组查询在大数据表中会明显变慢。</p>











