相关： 键鼠助手 5.0 资源汇总：主程序 / 文档 / 配套工具下载

一句话用法

local t = GetUpTime()   -- 单位毫秒，整型；返回值一般只用来算差值

接口说明

几点需要说清楚：

• 不是「当前时间」：它是「开机以来的时长」，设备上电时从 0 开始，不表示几点几分，也不是时间戳。它的用途是算差值。
• 单位是毫秒，返回值是整型：脚本里 math.type(GetUpTime()) 得到 integer，可以直接参与加减乘除与比较。
• 分辨率 1 毫秒：设备内部按更细的步长计数，换算成毫秒时向下取整，所以相邻两次调用可能返回同一个值。
• 不会溢出：毫秒计数是 64 位整数，连续开机到溢出需要以「亿年」计，正常使用无需关心。
• 大小写不敏感：GetUpTime() 与 getuptime() 是同一个函数，和 IsKeyDown / iskeydown 的规则一致。
• 它是「读时钟」，不是「等待」：调用本身几乎不耗时、不会阻塞宏；要等一段时间请用 Delay(毫秒)。

在电脑上先调好再上机：两种环境的时间原点不同

同一个 GetUpTime()，在两个地方跑，时间原点不一样：

所以不要跨环境比较绝对数值（电脑上的 1200 和真机上的 1200 不是一个起点），只比较同一个环境内的差值。

用法一：测量一段宏的耗时

取两次时间戳相减，就能知道中间这段动作真实花了多久 —— 排查「宏为什么比预期慢」时很有用。

local t0 = GetUpTime()

KeyTap("a")
Delay(300)
KeyTap("b")

Log("这一段耗时 %d ms", GetUpTime() - t0)

Log 的首个参数带 %d 时按 printf 格式化，数字会原样打印出来，便于对照。

用法二：用绝对时间对齐，避免 Delay 累积误差

连续多次 Delay(500) 时，每一步自身的执行耗时会让整体越走越慢，误差逐次累加。
改用「目标时刻」判断，就能把每轮的落点重新拉回时间轴上：

-- 执行 4 轮，每轮之间间隔 500ms，落点分别对齐到 500 / 1000 / 1500 / 2000ms
local t0 = GetUpTime()
for i = 1, 4 do
    KeyTap("f")
    local target = i * 500
    while GetUpTime() - t0 < target do
        Delay(10)   -- 小步让出，别用空转等待
    end
end

要点：等待循环里一定要有 Delay(小值)，不要把 while 写成不带 Delay 的紧凑空转。

用法三：把宏做成固定的节拍

需要「每 1 秒做一件事、共 5 次」这类节奏时，用时间戳做判断比用 Delay 堆叠更稳：

local last = GetUpTime()
local count = 0
while count < 5 do
    local now = GetUpTime()
    if now - last >= 1000 then
        last = last + 1000      -- 以理论落点累加，不丢节拍
        KeyTap("space")
        count = count + 1
    end
    Delay(10)
end

last = last + 1000（而不是 last = now）能让误差不累积：即使某轮判定晚了一点，下一轮的落点仍然回到原来的时间轴上。

版本要求与兼容性

所以升级软件时，请把固件一并升到配套版本。软件与固件的版本对应关系，参考资源汇总帖里的说明。

还是有问题？

在本帖下回复，写清楚：软件版本（关于页的 Software version）+ 固件版本 + 你脚本里调用 GetUpTime() 的那几行 + 现象。