HPEXPIREAT

HPEXPIREAT key unix-time-milliseconds [NX | XX | GT | LT]
  FIELDS numfields field [field ...]

可用版本

Redis 开源版 7.4.0

时间复杂度

O(N)，其中 N 是指定字段的数量

ACL 类别

@write、 @hash、 @fast、

HPEXPIREAT 命令与 HEXPIREAT 具有相同的效果和语义，但指定字段过期的 Unix 时间是以自 Unix 纪元以来的毫秒数而不是秒数。

选项

HPEXPIREAT 命令支持一组选项

• NX -- 对于每个指定字段，仅在字段没有设置过期时间时才设置过期时间。
• XX -- 对于每个指定字段，仅在字段已设置过期时间时才设置过期时间。
• GT -- 对于每个指定字段，仅在新过期时间大于当前过期时间时才设置过期时间。
• LT -- 对于每个指定字段，仅在新过期时间小于当前过期时间时才设置过期时间。

对于 GT 和 LT，非易失性键被视为具有无限 TTL。NX、XX、GT 和 LT 选项是互斥的。

示例

redis> HSET mykey field1 "hello" field2 "world"
(integer 2)
redis> HPEXPIREAT mykey 1715704971000 FIELDS 2 field1 field2
1) (integer) 1
2) (integer) 1
redis> HPTTL mykey FIELDS 2 field1 field2
1) (integer) 303340
2) (integer) 303340

RESP2/RESP3 回复

以下之一

• 数组回复。对于每个字段
  • 整数回复：如果提供的哈希键中不存在该字段，或者提供的键不存在，则返回 -2。
  • 整数回复：如果未满足指定的 NX、XX、GT 或 LT 条件，则返回 0。
  • 整数回复：如果过期时间已设置/更新，则返回 1。
  • 整数回复：当调用 HEXPIRE 或 HPEXPIRE 时指定了 0 秒或 0 毫秒，或者当调用 HEXPIREAT 或 HPEXPIREAT 时指定了过去的 Unix 时间（秒或毫秒）时，返回 2。
• 简单错误回复:
  • 如果解析失败、缺少必需参数、指定了未知参数，或者参数值类型错误或超出范围。
  • 如果提供的键存在但不是哈希类型。