pexpire.3valkey - Man Page

PEXPIRE key milliseconds [NX | XX | GT | LT]

This command works exactly like EXPIRE but the time to live of the key is specified in milliseconds instead of seconds.

The PEXPIRE command supports a set of options

• 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: 0if the timeout was not set. For example, if the key doesn’t exist, or the operation skipped because of the provided arguments.
• valkey-protocol(7) Integer reply: 1 if the timeout was set.

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> PEXPIRE mykey 1500
(integer) 1
127.0.0.1:6379> TTL mykey
(integer) 1
127.0.0.1:6379> PTTL mykey
(integer) 1480
127.0.0.1:6379> PEXPIRE mykey 1000 XX
(integer) 1
127.0.0.1:6379> TTL mykey
(integer) 1
127.0.0.1:6379> PEXPIRE mykey 1000 NX
(integer) 0
127.0.0.1:6379> TTL mykey
(integer) 1

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), pexpireat(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)