from datetime import datetime


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

    功能说明:
        - 这个函数用于拿到当前的时分秒，不返回年月日。
        - 返回结果固定是 ``HH:MM:SS`` 这种字符串格式，适合显示当前时钟、拼接提示语或做简单时间展示。
        - 函数不需要传参数，调用一次就能得到当前系统时间的时分秒部分。

    Returns:
        返回当前时间字符串，例如 ``16:25:30``。
    """
    return datetime.now().strftime("%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：应用场景-给操作日志补上当前时分秒 =====")
    日志内容 = {
        "action": "导出报表",
        "time_only": 取当前时间(),
    }
    print("日志内容:", 日志内容)
