from datetime import datetime


def 取当前年月() -> str:
    """返回当前系统的年月字符串。

    功能说明:
        - 这个函数用于获取当前年月，不包含具体的日和时分秒。
        - 返回格式固定为 ``YYYY-MM``。
        - 适合生成月报文件名、按月份建目录和做月份筛选。

    Returns:
        返回当前年月字符串，例如 ``2026-03``。
    """
    return datetime.now().strftime("%Y-%m")


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

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

    print("\n===== 示例3：用于生成月报目录 =====")
    目录 = f"./月报/{取当前年月()}/"
    print("结果:", 目录)

    print("\n===== 示例4：用于页面显示月份 =====")
    标题 = f"{取当前年月()} 数据总览"
    print("结果:", 标题)

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

    print("\n===== 示例6：应用场景-按年月归档订单文件 =====")
    文件名 = f"orders_{取当前年月()}.csv"
    print("文件名:", 文件名)
