from datetime import datetime


def 取系统时间戳():
    """返回当前系统时间戳。

    功能说明:
        - 这个函数用于获取当前系统时间对应的 Unix 时间戳，单位是秒。
        - 时间戳适合做排序、比较时间先后、保存到数据库等场景。
        - 如果获取失败，函数会返回 ``False``。

    Returns:
        成功时返回整数时间戳；失败时返回 ``False``。
    """
    try:
        当前时间戳 = int(datetime.now().timestamp())
        return 当前时间戳
    except Exception:
        return False


if __name__ == "__main__":
    print("===== 示例1：直接获取当前时间戳 =====")
    print("结果:", 取系统时间戳())

    print("\n===== 示例2：查看返回值类型 =====")
    当前时间戳 = 取系统时间戳()
    print("结果:", 当前时间戳, "类型:", type(当前时间戳).__name__)

    print("\n===== 示例3：用于记录任务开始时间 =====")
    开始时间戳 = 取系统时间戳()
    print("任务开始时间戳:", 开始时间戳)

    print("\n===== 示例4：连续调用两次比较大小 =====")
    第一次 = 取系统时间戳()
    第二次 = 取系统时间戳()
    print("第一次:", 第一次)
    print("第二次:", 第二次)
    print("第二次是否大于等于第一次:", 第二次 >= 第一次)

    print("\n===== 示例5：用于拼接缓存键 =====")
    缓存键 = f"user_report_{取系统时间戳()}"
    print("结果:", 缓存键)

    print("\n===== 示例6：应用场景-给消息队列任务生成入队时间 =====")
    任务数据 = {
        "task_name": "同步库存",
        "queued_at": 取系统时间戳(),
    }
    print("任务数据:", 任务数据)
