from datetime import datetime


def 取当前日期() -> str:
    """返回当前系统日期。

    功能说明:
        - 这个函数用于拿到今天的日期，只返回年月日，不带时分秒。
        - 返回结果固定是 ``YYYY-MM-DD`` 这种字符串格式，适合直接写到日志、文件名或表单里。
        - 函数不需要传参数，调用一次就能得到当前系统日期。

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


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

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

    print("\n===== 示例3：用于生成日志文件名 =====")
    文件名 = f"log_{取当前日期()}.txt"
    print("结果:", 文件名)

    print("\n===== 示例4：用于显示页面上的今天日期 =====")
    页面标题 = f"今日数据：{取当前日期()}"
    print("结果:", 页面标题)

    print("\n===== 示例5：连续调用两次看看格式是否一致 =====")
    print("结果1:", 取当前日期())
    print("结果2:", 取当前日期())

    print("\n===== 示例6：应用场景-按日期归档日报文件 =====")
    日期目录 = f"./日报/{取当前日期()}/销售日报.xlsx"
    print("归档路径:", 日期目录)
