from datetime import datetime


def 验证时间格式(时间字符串: str, 格式: str = "%Y-%m-%d %H:%M:%S") -> bool:
    """检查一个时间字符串是否符合指定格式。

    功能说明:
        - 这个函数用于验证时间字符串写得对不对。
        - 默认检查 ``YYYY-MM-DD HH:MM:SS`` 这种最常见的标准时间格式。
        - 你也可以自己传别的格式，让它帮你按新格式检查。
        - 只要格式不对或日期本身不存在，函数都会返回 ``False``。

    Args:
        时间字符串: 要验证的时间字符串。
        格式: 期望的时间格式。

    Returns:
        符合格式返回 ``True``，否则返回 ``False``。
    """
    try:
        datetime.strptime(时间字符串.strip(), 格式)
        return True
    except Exception:
        return False


if __name__ == "__main__":
    print("===== 示例1：验证标准时间格式 =====")
    print("结果:", 验证时间格式("2026-03-20 10:30:45"))

    print("\n===== 示例2：标准格式但日期不存在 =====")
    print("结果:", 验证时间格式("2026-02-30 10:30:45"))

    print("\n===== 示例3：验证自定义日期格式 =====")
    print("结果:", 验证时间格式("2026/03/20", "%Y/%m/%d"))

    print("\n===== 示例4：自定义格式不匹配 =====")
    print("结果:", 验证时间格式("2026-03-20", "%Y/%m/%d"))

    print("\n===== 示例5：输入空字符串 =====")
    print("结果:", 验证时间格式(""))

    print("\n===== 示例6：应用场景-先验证用户输入，再决定是否入库 =====")
    用户输入 = "2026-03-20 18:00:00"
    if 验证时间格式(用户输入):
        print("可以入库:", 用户输入)
    else:
        print("时间格式不正确")
