如何在 Laravel 中获取指定年份中每个月的起始与结束时间-php教程-PHP中文网

如何在 Laravel 中获取指定年份中每个月的起始与结束时间

本文介绍使用 carbon 库在 laravel 中高效生成指定年份 12 个月各自的起始（每月第一天 00:00:00）和结束时间（每月最后一天 23:59:59）的方法，并提供可直接复用的封装函数及关键注意事项。

本文介绍使用 carbon 库在 laravel 中高效生成指定年份 12 个月各自的起始（每月第一天 00:00:00）和结束时间（每月最后一天 23:59:59）的方法，并提供可直接复用的封装函数及关键注意事项。

在 Laravel 开发中，常需按月统计、归档或生成时间范围筛选条件（如报表查询、日志分析等）。Carbon 作为 Laravel 内置的时间处理库，提供了简洁可靠的方式来操作日期。以下是一个健壮、无副作用的工具方法，用于获取任意年份所有月份的起止时间：

use Carbon\Carbon;

public function getStartAndEndOfMonthForGivenYear(int $year): array
{
    $data = [];
    $base = Carbon::create($year, 1, 1); // 固定为该年1月1日，避免时区/当前日期干扰

    for ($month = 1; $month startOfDay();     // YYYY-MM-01 00:00:00
        $end   = Carbon::create($year, $month, 1)->endOfMonth();       // YYYY-MM-DD 23:59:59

        $data[] = [
            'start' => $start->toDateTimeString(),
            'end'   => $end->toDateTimeString(),
        ];
    }

    return $data;
}

✅ 关键优化说明：

避免原示例中 $currentYear->startOfMonth()->addMonth() 的链式调用陷阱（startOfMonth() 返回新实例，addMonth() 作用于原实例，易导致逻辑错乱）；
每次循环独立创建 Carbon 实例，确保月份计算准确、无状态污染；
使用 startOfDay() 和 endOfMonth() 确保时间精度：前者固定为 00:00:00，后者自动适配闰年与大小月（如 2 月 28/29 日、4/6/9/11 月 30 日）。

? 使用示例：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

$periods = $this->getStartAndEndOfMonthForGivenYear(2024);
// 输出示例（2024年1月）：
// [
//   'start' => '2024-01-01 00:00:00',
//   'end'   => '2024-01-31 23:59:59'
// ]

⚠️ 注意事项：