HPEXPIRE

HPEXPIRE key milliseconds [NX | XX | GT | LT] FIELDS numfields
  field [field ...]

可用版本

7.4.0

时间复杂度

O(N)，其中 N 是命令的参数数量。

ACL 类别

@write, @hash, @fast,

此命令的工作方式类似于 HEXPIRE，但字段的过期时间是以毫秒而不是秒为单位指定的。

选项

HPEXPIRE 命令支持一组选项。

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

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

示例

redis> HSET mykey field1 "hello" field2 "world"
(integer 2)
redis> HPEXPIRE mykey 2000 FIELDS 2 field1 field2
1) (integer) 1
2) (integer) 1
redis> HGETALL mykey
(empty array)

RESP2/RESP3 响应

以下之一

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