Laravel中如何基于Carbon获取自定义财季编号？

问题描述 #

我正在构建一个以财季为时间轴的图表，需要使用自定义的财季划分：

4月-6月为Q1，7月-9月为Q2，10月-12月为Q3，1月-3月为Q4

目前我有一段生成过去6个月月份标签的代码：

for($i=0; $i<6; $i++) { 
    $labels[] = Carbon::now()->startOfMonth()->subMonths($i)->format('M Y'); 
}

现在需要修改这段代码，让它生成对应月份所属的财季标签，比如2024年1月应该显示为2023 Q4，2024年5月显示为2024 Q1，请问该怎么实现？

解决方案 #

没问题，咱们可以通过自定义财季判断逻辑来实现这个需求，核心是搞清楚每个月份对应的财季，以及财季所属的年份——毕竟1-3月的Q4属于上一个自然年，这一点是关键。我们可以基于Carbon的日期处理能力，封装一个小函数来生成财季标签，替换掉原来的月份格式化逻辑就行。

完整实现代码 #

use Carbon\Carbon;

// 封装一个函数，根据日期获取对应的财季标签
function getFiscalQuarterLabel(Carbon $date) {
    $month = $date->month;
    $year = $date->year;
    
    // 按自定义规则判断财季和对应年份
    if ($month >= 4 && $month <= 6) {
        $quarter = 'Q1';
        // 4-6月直接用当前自然年的Q1
    } elseif ($month >= 7 && $month <= 9) {
        $quarter = 'Q2';
        // 7-9月用当前自然年的Q2
    } elseif ($month >= 10 && $month <= 12) {
        $quarter = 'Q3';
        // 10-12月用当前自然年的Q3
    } else {
        // 1-3月属于上一年的Q4，所以年份要减1
        $quarter = 'Q4';
        $year -= 1;
    }
    
    return "{$year} {$quarter}";
}

// 生成过去6个月对应的财季标签
$labels = [];
for($i=0; $i<6; $i++) {
    $currentMonth = Carbon::now()->startOfMonth()->subMonths($i);
    $labels[] = getFiscalQuarterLabel($currentMonth);
}

// 可选：如果需要每个财季只显示一次标签，就去重并保持顺序
$labels = array_unique($labels);
rsort($labels); // 确保标签是从新到旧排序的

代码说明 #

1. 财季判断逻辑：完全按照你给定的规则来，重点处理了1-3月的年份偏移——比如2025年1月的Q4，对应的年份是2024，而不是2025。
2. 标签生成：循环里还是按原来的逻辑获取过去6个月的日期，只是把原来的format('M Y')换成了我们自定义的函数，直接得到财季标签。
3. 去重处理：因为过去6个月可能包含同一个财季的多个月份（比如4、5、6月都属于Q1），如果你的图表需要每个财季只显示一个标签，就加上array_unique和rsort——rsort是为了保持标签从新到旧的顺序，因为array_unique会打乱原有排序。

示例输出 #

假设现在是2024年5月，运行这段代码后，初始的$labels会是：

[
    "2024 Q1",
    "2024 Q1",
    "2024 Q1",
    "2023 Q4",
    "2023 Q4",
    "2023 Q4"
]

去重之后就变成了：

[
    "2024 Q1",
    "2023 Q4"
]

内容的提问来源于stack exchange，提问作者Nitish Kumar