HTTL

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

语法

HTTL key FIELDS numfields field [field ...]

引入版本：7.4.0

复杂度摘要：O(N)

返回具有设定过期时间的哈希键字段的剩余 TTL（生存时间）。这种自省功能允许您检查给定哈希字段将继续作为哈希键的一部分的秒数。

另请参见 HPTTL 命令，该命令以毫秒分辨率返回相同信息。

必需参数

key

保存哈希值的键的名称。

FIELDS numfields field [field ...]

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

示例

redis> HTTL 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> HTTL mykey FIELDS 3 field1 field2 field3
1) (integer) 283
2) (integer) -1
3) (integer) -2

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

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

RESP3

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

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