本文介绍如何在 laravel 9 中基于不连续的日期价格数据，动态补全指定时间范围内每一天的记录（沿用最近有效价格），生成完整、有序、无间隙的日期集合。
本文介绍如何在 laravel 9 中基于不连续的日期价格数据，动态补全指定时间范围内每一天的记录（沿用最近有效价格），生成完整、有序、无间隙的日期集合。
在酒店、短租或日历定价系统中，常采用“有效起始日+价格”模式存储费率（如：8月1日起价100，8月10日起调至110）。但前端渲染日历、导出报表或计算均价时，往往需要连续每日数据——即对 2022-08-03 至 2022-08-14 这12天，自动将 2022-08-01 的价格 100 延续覆盖到 03–09 日，再将 2022-08-10 的 110 延续至 14 日。
Laravel 9 结合 Carbon 的 CarbonPeriod 可优雅实现该逻辑。核心思路是：先获取区间内所有已存在记录 → 按日期升序排序 → 遍历目标日期范围 → 对每个日期，向前查找最近的有效价格记录（即“上一条价格生效日”）→ 构造填充项。
以下为推荐实现（无需写入数据库，纯内存集合构建）：
use Carbon\Carbon;
use Carbon\CarbonPeriod;
// 定义查询范围
$initDate = '2022-08-03';
$endDate = '2022-08-14';
$property = 1;
// 1. 获取该物业在 [initDate, endDate] 内所有已定义价格记录（含边界）
$baseRecords = Calendar::whereBetween('date', [$initDate, $endDate])
->where('property_id', $property)
->orderBy('date')
->get();
// 2. 获取该物业在 initDate 之前（含）的最新一条记录（用于填补 initDate 之前的延续价格）
$latestBefore = Calendar::where('property_id', $property)
->where('date', 'orderByDesc('date')
->first();
// 3. 合并：若 latestBefore 存在且 date date prepend($latestBefore)->sortBy('date')
: $baseRecords;
// 4. 构建日期范围并逐日填充
$period = CarbonPeriod::create($initDate, $endDate);
$filled = collect();
foreach ($period as $date) {
$dateStr = $date->toDateString();
// 找出 dateStr 或之前最后一条有效记录（即价格生效日 ≤ 当前日期）
$activeRecord = $allRelevant->filter(fn($r) => $r->date last();
if ($activeRecord) {
$filled->push([
'property_id' => $property,
'price' => $activeRecord->price,
'date' => $dateStr,
]);
}
}
// $filled 现在是一个包含 12 条连续记录的 Illuminate\Support\Collection
// 可直接返回 API、传给 Blade 或转为模型集合
return $filled->map(fn($item) => new Calendar($item));
✅ 关键说明与注意事项：
- ✅ 不修改数据库：本方案全程在内存中构建结果，安全无副作用；若需持久化填充，可将
push()替换为Calendar::create(...)。 - ✅ 正确处理边界：通过
where('date', ' + <code>orderByDesc('date')精确获取“最接近但不晚于起始日”的价格锚点，避免误取过早无效记录。 - ✅ 性能友好：仅执行 2 次查询（区间内 + 最近锚点），后续填充为 O(n) 内存操作，适用于数百天范围。
- ⚠️ 注意字段名拼写：原问题中
where('property_id ', ...)多了一个空格，实际使用请确保列名准确（property_id）。 - ? 扩展建议：如需支持多物业批量处理，可将逻辑封装为 Eloquent Scope 或 Service 类；若数据量极大（万级日期），建议预计算并缓存至 Redis。
最终输出即为结构清晰、日期连续、价格继承合理的标准集合，完美匹配日历渲染与统计分析需求。
