from datetime import datetime


def 获取时间间隔秒数(开始时间, 结束时间):
    """计算两个时间之间相差多少秒。

    功能说明:
        - 这个函数用于计算两个标准时间之间的秒数差。
        - 返回的是绝对值，所以开始时间和结束时间谁早谁晚都可以。
        - 适合做超时计算、任务耗时统计、播放时长统计。
        - 输入格式不正确时，函数返回 ``False``。

    Args:
        开始时间: 标准时间字符串，格式为 ``YYYY-MM-DD HH:MM:SS``。
        结束时间: 标准时间字符串，格式为 ``YYYY-MM-DD HH:MM:SS``。

    Returns:
        成功时返回整数秒数；失败时返回 ``False``。
    """
    try:
        开始 = datetime.strptime(开始时间, "%Y-%m-%d %H:%M:%S")
        结束 = datetime.strptime(结束时间, "%Y-%m-%d %H:%M:%S")
        时间间隔秒数 = abs((结束 - 开始).total_seconds())
        return int(时间间隔秒数)
    except Exception:
        return False


if __name__ == "__main__":
    print("===== 示例1：正常计算两个时间的秒数差 =====")
    print("结果:", 获取时间间隔秒数("2026-03-20 10:00:00", "2026-03-20 10:01:30"))

    print("\n===== 示例2：前后顺序交换，结果仍然一样 =====")
    print("结果:", 获取时间间隔秒数("2026-03-20 10:01:30", "2026-03-20 10:00:00"))

    print("\n===== 示例3：两个时间完全相同 =====")
    print("结果:", 获取时间间隔秒数("2026-03-20 10:00:00", "2026-03-20 10:00:00"))

    print("\n===== 示例4：输入错误格式 =====")
    print("结果:", 获取时间间隔秒数("2026/03/20 10:00:00", "2026-03-20 10:01:30"))

    print("\n===== 示例5：输入不存在的日期 =====")
    print("结果:", 获取时间间隔秒数("2026-02-30 10:00:00", "2026-03-20 10:01:30"))

    print("\n===== 示例6：应用场景-计算订单从下单到支付用了多少秒 =====")
    下单时间 = "2026-03-20 10:00:00"
    支付时间 = "2026-03-20 10:03:42"
    print("支付耗时(秒):", 获取时间间隔秒数(下单时间, 支付时间))
