from datetime import datetime


def 取当前月份() -> int:
    """返回当前系统月份。

    功能说明:
        - 这个函数用于获取当前的月份。
        - 返回结果是整数，范围通常是 ``1`` 到 ``12``。
        - 适合做月份判断、月报筛选和月份计算前的取值。

    Returns:
        返回当前月份，例如 ``3``。
    """
    return datetime.now().month


if __name__ == "__main__":
    print("===== 示例1：直接获取当前月份 =====")
    print("结果:", 取当前月份())

    print("\n===== 示例2：查看返回值类型 =====")
    结果 = 取当前月份()
    print("结果:", 结果, "类型:", type(结果).__name__)

    print("\n===== 示例3：判断当前是否在上半年 =====")
    print("结果:", 取当前月份() <= 6)

    print("\n===== 示例4：用于拼接月份标题 =====")
    标题 = f"{取当前月份()}月数据"
    print("结果:", 标题)

    print("\n===== 示例5：连续调用两次 =====")
    print("结果1:", 取当前月份())
    print("结果2:", 取当前月份())

    print("\n===== 示例6：应用场景-生成当月报表文件名 =====")
    文件名 = f"{取当前月份()}月库存报表.xlsx"
    print("文件名:", 文件名)
