Python 生成每月15日与月末日期序列的规范方法

本文介绍如何使用 Python 稳健、可读地生成以指定起始日为起点、按“每月15日 + 月末”双频次规则递推的日期列表，适用于贷款还款、薪资发放等场景，并提供简洁可靠的实现方案。

本文介绍如何使用 Python 稳健、可读地生成以指定起始日为起点、按“每月15日 + 月末”双频次规则递推的日期列表，适用于贷款还款、薪资发放等场景，并提供简洁可靠的实现方案。

在金融与财务系统开发中，常需生成如“每月15日及当月最后一天”的交替付款日序列（即 15_EOM 模式）。该序列必须严格满足两个核心要求：

• 起始日即首期付款日（如 2024-03-31）；
• 后续日期严格按“15日 → 月末 → 15日 → 月末…”交替推进，且每对日期属于同一自然月或连续月，避免跨月错位（如 4/15 → 4/30 → 5/15 → 5/31），更不可出现 5/16、12/01 等非目标日。

原代码逻辑复杂、分支冗余（如手动处理12月跳转、错误使用 timedelta(15) 计算月末）、且依赖未定义变量（如 pmtmonth 多处误用），导致结果混乱（含 2024-11-16、2024-12-01 等无效日期）。

✅ 正确解法应基于状态驱动+确定性规则：

1. 起始日固定为 firstpaymentdate；
2. 若当前日是15日 → 下一日取当月最后一天；
3. 若当前日是月末 → 下一日取下月15日；
4. 重复 term - 1 次，共生成 term 个日期。

以下是精简、健壮、无外部依赖（仅标准库）的实现：

from datetime import date, datetime, timedelta

def get_last_day_of_month(year: int, month: int) -> int:
    """返回指定年月的最后一天日期（如2024-04 → 30）"""
    if month == 12:
        next_month = date(year + 1, 1, 1)
    else:
        next_month = date(year, month + 1, 1)
    return (next_month - timedelta(days=1)).day

def generate_15_eom_dates(
    first_payment_date: datetime,
    term: int,
    sm_type: str = "15_EOM"
) -> list[datetime]:
    """
    生成 '15_EOM' 模式的付款日期序列

    Args:
        first_payment_date: 首期付款日（datetime对象）
        term: 总期数（整数）
        sm_type: 频率类型，仅支持 "15_EOM"

    Returns:
        按时间顺序排列的 datetime 列表，长度为 term
    """
    if sm_type != "15_EOM":
        raise ValueError("Only '15_EOM' frequency is supported.")
    if term < 1:
        return []

    dates = [first_payment_date]
    current = first_payment_date.date()  # 统一转为 date 类型简化操作

    for _ in range(term - 1):
        if current.day == 15:
            # 当前是15日 → 取当月最后一天
            last_day = get_last_day_of_month(current.year, current.month)
            current = current.replace(day=last_day)
        else:
            # 当前是月末 → 取下月15日
            if current.month == 12:
                current = current.replace(year=current.year + 1, month=1, day=15)
            else:
                current = current.replace(month=current.month + 1, day=15)
        dates.append(datetime.combine(current, datetime.min.time()))

    return dates

# 使用示例
if __name__ == "__main__":
    firstpaymentdate = datetime.strptime("3/31/2024", "%m/%d/%Y")
    term = 16

    result = generate_15_eom_dates(firstpaymentdate, term)
    for dt in result:
        print(dt.strftime("%Y-%m-%d"))

输出示例（前8项）：

2024-03-31  
2024-04-15  
2024-04-30  
2024-05-15  
2024-05-31  
2024-06-15  
2024-06-30  
2024-07-15  
...

? 关键设计说明：

• ✅ 精准月末计算：get_last_day_of_month() 利用 date 加减法自动适配大小月与闰年，比 calendar.monthrange() 更直观且免导入；
• ✅ 状态明确：仅依据 current.day 判断下一步逻辑（15→月末，月末→下月15），杜绝歧义；
• ✅ 边界安全：replace() 显式处理12月→1月年份进位，避免 month=13 异常；
• ✅ 类型清晰：输入 datetime，内部用 date 运算，输出统一为 datetime，便于后续与 Pandas 或数据库交互。

⚠️ 注意事项：

• 起始日必须为合法日期（如不能是 2024-02-30）；
• 本方案假设 term 为正整数，若需支持动态终止条件（如截止某日期），可扩展为 while 循环 + 日期比较；
• 如需兼容 1_16 模式（每月1日 & 16日），只需新增分支并调整日期逻辑，架构已预留扩展点。

该方案兼顾正确性、可维护性与性能，可直接集成至生产级财务模块。