4-4-5财年日历年份切换bug修复：yyyy-mm与quarter字段年份错误

嘿，我刚好踩过4-4-5财年日历的这两个坑！这俩bug本质都是财年边界的年份映射逻辑没处理到位，咱们一步步来搞定：

先明确核心规则 #

4-4-5财年的核心是：全年12个月按4周、4周、5周循环，总周数52；每5-6年会出现一次53周的情况（当年有53个周六时），此时最后一个月会多1周。财年的结束通常是自然年的最后一个周六，结束日之后的日期就属于下一个财年。

场景1：普通年份年末跨财年日期（如2012年末→2013财年） #

问题根源 #

当前代码大概率是直接用自然年年份作为财年年份，没有判断日期是否已经跨过了当年财年的结束日（最后一个周六）。比如2012年的财年结束日是12月29日（周六），12月30日（周日）已经属于2013财年，但代码还在用2012年计算。

修正方案 #

先写一个辅助函数获取当年财年的结束日期（最后一个周六），再判断目标日期是否在结束日之后：

import datetime

def get_fiscal_year_end(date):
    # 获取当年12月31日
    year_end = datetime.date(date.year, 12, 31)
    # 调整到当年最后一个周六：isoweekday中周六=6，周日=7
    days_to_subtract = (year_end.isoweekday() - 6) % 7
    fiscal_end = year_end - datetime.timedelta(days=days_to_subtract)
    return fiscal_end

然后修正财年计算逻辑：

def get_fiscal_year(date):
    fiscal_end = get_fiscal_year_end(date)
    # 场景1：日期在当年财年结束后，属于下一个财年
    if date > fiscal_end:
        return date.year + 1
    # 先留个位置给场景2的逻辑，后面补
    return date.year

场景2：53周年份的年初日期（如2022年1月1日→2021财年Q4） #

问题根源 #

53周的情况是因为某自然年包含了上一个财年的第53周，比如2022年1月1日属于2021财年的第53周，但代码直接用自然年2022计算，导致财年、财月、季度全部错误。

修正方案 #

利用ISO周的特性：ISO周的年份会和自然年不一致（比如2022年1月1日的ISO周年份是2021），结合周数是否为53来判断：

把get_fiscal_year函数补全：

def get_fiscal_year(date):
    fiscal_end = get_fiscal_year_end(date)
    # 场景1：日期在当年财年结束后，属于下一个财年
    if date > fiscal_end:
        return date.year + 1
    # 场景2：判断是否属于上一个财年的53周
    iso_year, iso_week, _ = date.isocalendar()
    if iso_year != date.year and iso_week == 53:
        return iso_year
    # 其他正常情况
    return date.year

再修正财月和季度的计算，确保和正确的财年绑定：

def get_fiscal_month_and_quarter(date):
    fiscal_year = get_fiscal_year(date)
    # 获取当前财年的起始日期（上一个财年结束日的次日）
    prev_fiscal_end = get_fiscal_year_end(datetime.date(fiscal_year - 1, 1, 1))
    fiscal_start = prev_fiscal_end + datetime.timedelta(days=1)
    
    # 计算当前日期在财年中的周数
    days_since_start = (date - fiscal_start).days
    fiscal_week = days_since_start // 7 + 1  # 财年周数从1开始
    
    # 场景2的特殊处理：53周直接归到财年12月、Q4
    if fiscal_week == 53:
        return 12, f"Q4 {fiscal_year}"
    
    # 普通4-4-5周数分配：[4,4,5,4,4,5,4,4,5,4,4,5]
    month_weeks = [4,4,5,4,4,5,4,4,5,4,4,5]
    cumulative_weeks = 0
    for month_idx, weeks in enumerate(month_weeks):
        cumulative_weeks += weeks
        if fiscal_week <= cumulative_weeks:
            month = month_idx + 1
            quarter = (month - 1) // 3 + 1
            return month, f"Q{quarter} {fiscal_year}"
    
    # 兜底返回（理论上不会走到这里）
    return 12, f"Q4 {fiscal_year}"

测试验证 #

• 场景1测试：2012年12月30日（周日）
  get_fiscal_year_end(2012)返回2012-12-29（周六），由于2012-12-30 > 2012-12-29，财年返回2013，财月1，季度Q1 2013，符合预期。
• 场景2测试：2022年1月1日
  date.isocalendar()返回(2021, 53, 6)，iso_year=2021≠2022且iso_week=53，财年返回2021，财月12，季度Q4 2021，符合预期。

小提示：如果你的公司财年起始不是自然年最后一个周六之后（比如有的财年从2月开始），只需要调整get_fiscal_year_end的逻辑，把财年结束日期改成你公司对应的规则即可。

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