HASH
获取 HASH 过期时间
读取指定 HASH 键的过期状态或剩余秒数到变量。
命令用途
Hash-GetE 对应的实际命令写法是 HASH <标识> GetE，用于读取指定 HASH 键的过期状态或剩余秒数到变量。
它常见于冷却提示、限时状态显示和过期逻辑判断前的剩余时间获取。
命令名
Hash-GetE
调用格式
HASH <标识> GetE <KEY> <变量>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要查询的 HASH 容器标识。 |
GetE | 是 | 固定子命令，表示读取过期信息。 |
KEY | 是 | 要查询的键名。 |
变量 | 是 | 用于接收过期状态或剩余秒数的变量。 |
返回或影响
- 该命令会把过期信息写入目标变量。
- 返回
-2表示键不存在。 - 返回
-1表示永久不过期。 - 返回大于等于
0的整数时，表示剩余过期秒数。
示例
基础用法
#ACT
HASH 用户状态 GetE 冷却结束 M10
#IF
Large M10 0
#SAY
当前冷却还有剩余时间。
这段写法适合先把某个限时键的剩余秒数写入 M10，再决定后续提示逻辑。
注意事项
- 这条命令返回的是状态值或秒数，不是键本身的业务数据。
-2、-1和>=0三种返回含义应在后续脚本里明确区分处理。