Laravel 中按日期范围查询并补全缺失日期的计数（含零值）-php教程-PHP中文网

Laravel 中按日期范围查询并补全缺失日期的计数（含零值）

在 laravel 中实现按指定日期范围统计每日数据量，即使某日无记录也返回 0，需结合 carbonperiod 生成完整日期序列，并对每日期单独查询或使用 left join + 日历表方式优化。

在 laravel 中实现按指定日期范围统计每日数据量，即使某日无记录也返回 0，需结合 carbonperiod 生成完整日期序列，并对每日期单独查询或使用 left join + 日历表方式优化。

在实际业务中（如后台数据看板、用户活跃度分析），我们常需获取连续日期区间内的聚合统计（如每日新增用户数），但数据库中仅存有发生行为的日期记录。若直接 GROUP BY date 查询，缺失日期将完全不出现，无法满足前端图表渲染所需的完整时间轴。Laravel 本身不提供内置“日期补全”功能，需通过逻辑层补全或数据库层构造日历序列来解决。

✅ 推荐方案：CarbonPeriod + 批量查询（简洁可靠，适合中小数据量）

首先确保已安装 nesbot/carbon（Laravel 默认已包含）：

composer require nesbot/carbon

然后使用 CarbonPeriod 生成目标日期范围，并逐日查询计数：

use Carbon\CarbonPeriod;
use Illuminate\Support\Facades\DB;

$startDate = '2022-07-25';
$endDate   = '2022-08-02';

$period = CarbonPeriod::create($startDate, $endDate);
$result = [];

foreach ($period as $date) {
    $count = DB::table('your_table_name')
        ->whereDate('date', $date->format('Y-m-d'))
        ->count('user_id');

    $result[] = [
        'date'       => $date->format('Y-m-d'),
        'user_count' => (int) $count,
    ];
}

// 返回 JSON 或用于视图
return response()->json($result);

✅ 输出示例：

[
  {"date":"2022-07-25","user_count":0},
  {"date":"2022-07-26","user_count":0},
  ...
  {"date":"2022-08-02","user_count":2}
]

⚠️ 注意事项与优化建议

N+1 查询风险：上述方法会执行 n 次数据库查询（n = 天数）。若日期跨度大（如 365 天），性能可能下降。此时推荐以下进阶方案：

Laravel Cloud
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

数据库日历表（最优性能）：
创建一个只含单列 date 的日历辅助表（预填充 10 年日期），再通过 LEFT JOIN 关联主表：

$startDate = '2022-07-25';
$endDate   = '2022-08-02';

$result = DB::table(DB::raw("(SELECT DATE_ADD(?, INTERVAL seq DAY) AS date 
                              FROM (SELECT 0 AS seq UNION SELECT 1 UNION SELECT 2 UNION ... ) s 
                              WHERE DATE_ADD(?, INTERVAL seq DAY) select('calendar.date', DB::raw('COALESCE(COUNT(t.user_id), 0) as user_count'))
    ->leftJoin('your_table_name as t', DB::raw('DATE(t.date)'), '=', 'calendar.date')
    ->groupBy('calendar.date')
    ->orderBy('calendar.date', 'DESC')
    ->setBindings([$startDate, $startDate, $endDate])
    ->get();

? 实际项目中建议用真实日历表替代 UNION 临时构造，更稳定高效。

Eloquent 替代写法（如模型为 Activity）：

$dates = collect(CarbonPeriod::create($startDate, $endDate))
    ->mapWithKeys(fn($d) => [$d->format('Y-m-d') => 0]);

$counts = Activity::whereBetween('date', [$startDate, $endDate])
    ->selectRaw('DATE(date) as date, COUNT(*) as count')
    ->groupBy('date')
    ->pluck('count', 'date'); // key: date, value: count

$result = $dates->merge($counts)->map(fn($count, $date) => [
    'date'       => $date,
    'user_count' => (int) $count,
])->values();