from datetime import datetime


def 取当前年月日时分秒() -> str:
    """返回当前完整时间字符串。

    功能说明:
        - 这个函数用于一次性获取当前的年月日时分秒。
        - 返回格式固定为 ``YYYY-MM-DD HH:MM:SS``。
        - 适合记录完整日志时间、生成详细时间标签或做时间展示。

    Returns:
        返回当前完整时间字符串，例如 ``2026-03-20 16:25:30``。
    """
    return datetime.now().strftime("%Y-%m-%d %H:%M:%S")


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：应用场景-给导出记录补上完整创建时间 =====")
    记录 = {"file": "report.xlsx", "created_at": 取当前年月日时分秒()}
    print("记录:", 记录)
