- Usage:
-
PEXPIRE key milliseconds [ NX | XX | GT | LT ]
- Complexity:
- O(1)
- Since:
- 2.6.0
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 one-
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. -
Integer reply:
1if the timeout was set.
This command works exactly like EXPIRE but the time to live of the key is
specified in milliseconds instead of seconds.
Options
The PEXPIRE command supports a set of options
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.
Examples
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
RESP2/RESP3 Reply
One of the following:
History
| Version | Change |
|---|---|
| 7.0.0 | Added options: |