HEXPIRETIME

以 Unix 时间戳形式返回哈希字段的过期时间，以秒为单位。

语法

HEXPIRETIME key FIELDS numfields field [field ...]

引入版本：7.4.0

复杂度摘要：O(N)

返回自 Unix 纪元以来给定键的字段将过期的绝对 Unix 时间戳（以秒为单位）。

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

必需参数

key

保存哈希值的键的名称。

FIELDS numfields field [field ...]

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

示例

redis> HSET mykey field1 "hello" field2 "world"
(integer) 2
redis> HEXPIRE mykey 300  FIELDS 2 field1 field2
1) (integer) 1
2) (integer) 1
redis> HEXPIRETIME mykey FIELDS 2 field1 field2
1) (integer) 1715705914
2) (integer) 1715705914

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

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

RESP3

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

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