from datetime import datetime, timedelta


def 取昨天日期() -> str:
    """返回昨天的日期字符串。

    功能说明:
        - 这个函数用于获取昨天的日期。
        - 返回格式固定为 ``YYYY-MM-DD``。
        - 适合按天查询昨天数据、生成昨天报表和写时间标签。

    Returns:
        返回昨天的日期字符串。
    """
    return (datetime.now() - timedelta(days=1)).strftime("%Y-%m-%d")


if __name__ == "__main__":
    print("===== 示例1：直接获取昨天日期 =====")
    print("结果:", 取昨天日期())

    print("\n===== 示例2：查看返回值类型 =====")
    结果 = 取昨天日期()
    print("结果:", 结果, "类型:", type(结果).__name__)

    print("\n===== 示例3：用于查询昨天订单 =====")
    条件 = {"date": 取昨天日期()}
    print("结果:", 条件)

    print("\n===== 示例4：用于生成昨天报表文件名 =====")
    文件名 = f"sales_{取昨天日期()}.xlsx"
    print("结果:", 文件名)

    print("\n===== 示例5：连续调用两次 =====")
    print("结果1:", 取昨天日期())
    print("结果2:", 取昨天日期())

    print("\n===== 示例6：应用场景-按昨天日期统计登录人数 =====")
    查询日期 = 取昨天日期()
    print("准备统计日期:", 查询日期)
