HEXPIREAT

HEXPIREAT key unix-time-seconds [NX | XX | GT | LT] FIELDS numfields
  field [field ...]

Available since:

7.4.0

Time complexity:

O(N) where N is the number of specified fields

ACL categories:

@write, @hash, @fast,

HEXPIREAT 的效果和语义与 HEXPIRE 相同，但它不是指定 TTL（生存时间）的秒数，而是采用自 Unix 纪元以来的绝对 Unix 时间戳（以秒为单位）。过去的时间戳将立即删除该字段。

有关命令的具体语义，请参见HEXPIRE。

选项

HEXPIREAT 命令支持一组选项：

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

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

Example

redis> HSET mykey field1 "hello" field2 "world"
(integer 2)
redis> HEXPIREAT mykey 1715704971 FIELDS 2 field1 field2
1) (integer) 1
2) (integer) 1
redis> HTTL mykey FIELDS 2 field1 field2
1) (integer) 567
2) (integer) 567

RESP2/RESP3 回复

以下之一：

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