HPEXPIRETIME

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

语法

HPEXPIRETIME key FIELDS numfields field [field ...]

引入版本：7.4.0

复杂度摘要：O(N)

HPEXPIRETIME 与 HEXPIRETIME 具有相同的语义，但返回自 Unix 纪元以来的绝对 Unix 过期时间戳（以毫秒为单位），而不是秒。

必需参数

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> HPEXPIRETIME mykey FIELDS 2 field1 field2
1) (integer) 1715705913659
2) (integer) 1715705913659

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

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

RESP3

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

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