Sets the expiration time of a key in milliseconds.
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 expiryXX
– Set expiry only when the key has an existing
expiryGT
– Set expiry only when the new expiry is greater
than current oneLT
– Set expiry only when the new expiry is less than
current oneA 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:
Integer reply:
0
if the timeout was not set. For example, if the key
doesn’t exist, or the operation skipped because of the provided
arguments.
Integer reply:
1
if the timeout was set.
O(1)
@fast @keyspace @write
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
NX
, XX
,
GT
and LT
.COPY, DEL, DUMP, EXISTS, EXPIRE, EXPIREAT, EXPIRETIME, KEYS, MIGRATE, MOVE, OBJECT, OBJECT ENCODING, OBJECT FREQ, OBJECT HELP, OBJECT IDLETIME, OBJECT REFCOUNT, PERSIST, PEXPIREAT, PEXPIRETIME, PTTL, RANDOMKEY, RENAME, RENAMENX, RESTORE, SCAN, SORT, SORT_RO, TOUCH, TTL, TYPE, UNLINK, WAIT, WAITAOF.