HPTTL

返回哈希字段的 TTL（以毫秒为单位）。

语法

HPTTL key FIELDS numfields field [field ...]

引入版本：7.4.0

复杂度摘要：O(N)

与 HTTL 类似，此命令返回设置了过期时间的字段的剩余 TTL（生存时间），但以毫秒而不是秒为单位。

必需参数

key

保存哈希值的键的名称。

FIELDS numfields field [field ...]

用于检索剩余生存时间的哈希字段。 numfields 是字段的数量，后面跟着这些字段的名称。

示例

redis> HPTTL no-key FIELDS 3 field1 field2 field3
(nil)
redis> HSET mykey field1 "hello" field2 "world"
(integer) 2
redis> HEXPIRE mykey 300 FIELDS 2 field1 field3
1) (integer) 1
2) (integer) -2
redis> HPTTL mykey FIELDS 3 field1 field2 field3
1) (integer) 292202
2) (integer) -1
3) (integer) -2

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动

返回值

RESP2

• 数组回复。对于每个字段：
  • 整数回复：如果提供的哈希键中不存在该字段，或者提供的键不存在，则为 -2。
  • 整数回复：如果该字段存在但没有关联的到期设置，则为 -1。
  • 整数回复：TTL（以毫秒为单位）。

RESP3

• 数组回复。对于每个字段：
  • 整数回复：如果提供的哈希键中不存在该字段，或者提供的键不存在，则为 -2。
  • 整数回复：如果该字段存在但没有关联的到期设置，则为 -1。
  • 整数回复：TTL（以毫秒为单位）。

资料来源：Redis 官方 HPTTL 文档；中文内容参考 Redis 文档许可。