from datetime import datetime


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

    功能说明:
        - 这个函数用于获取当前的年份。
        - 返回结果是整数，适合直接参与计算、比较大小或拼接年份信息。
        - 函数不需要传参数，调用时会自动读取当前系统时间。

    Returns:
        返回当前年份，例如 ``2026``。
    """
    return datetime.now().year


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

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

    print("\n===== 示例3：用于判断是否是未来年份 =====")
    print("结果:", 取当前年份() > 2025)

    print("\n===== 示例4：用于拼接年度报表标题 =====")
    标题 = f"{取当前年份()}年度销售报表"
    print("结果:", 标题)

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

    print("\n===== 示例6：应用场景-按年份归档文件夹 =====")
    文件夹 = f"./归档/{取当前年份()}/"
    print("归档目录:", 文件夹)
