pexpireat.3valkey - Man Page

PEXPIREAT key unix-time-milliseconds [NX | XX | GT | LT]

PEXPIREAT has the same effect and semantic as EXPIREAT, but the Unix time at which the key will expire is specified in milliseconds instead of seconds.

The PEXPIREAT command supports a set of options since Redis OSS 7.0:

• NX – Set expiry only when the key has no expiry
• XX – Set expiry only when the key has an existing expiry
• GT – Set expiry only when the new expiry is greater than current one
• LT – Set expiry only when the new expiry is less than current one

A non-volatile key is treated as an infinite TTL for the purpose of GT and LT. The GT, LT and NX options are mutually exclusive.

One of the following:

• valkey-protocol(7) Integer reply: 1 if the timeout was set.
• valkey-protocol(7) Integer reply: 0 if the timeout was not set. For example, if the key doesn’t exist, or the operation was skipped due to the provided arguments.

O(1)

@fast @keyspace @write

• Available since: 2.6.0
• Changed in 7.0.0: Added options: NX, XX, GT and LT.

127.0.0.1:6379> SET mykey "Hello"
OK
127.0.0.1:6379> PEXPIREAT mykey 1555555555005
(integer) 1
127.0.0.1:6379> TTL mykey
(integer) -2
127.0.0.1:6379> PTTL mykey
(integer) -2

copy(3valkey), del(3valkey), dump(3valkey), exists(3valkey), expire(3valkey), expireat(3valkey), expiretime(3valkey), keys(3valkey), migrate(3valkey), move(3valkey), object(3valkey), object-encoding(3valkey), object-freq(3valkey), object-help(3valkey), object-idletime(3valkey), object-refcount(3valkey), persist(3valkey), pexpire(3valkey), pexpiretime(3valkey), pttl(3valkey), randomkey(3valkey), rename(3valkey), renamenx(3valkey), restore(3valkey), scan(3valkey), sort(3valkey), sort_ro(3valkey), touch(3valkey), ttl(3valkey), type(3valkey), unlink(3valkey), wait(3valkey), waitaof(3valkey)