PEXPIRE
Syntax
PEXPIRE key milliseconds [NX | XX | GT | LT]
- Available since:
- 2.6.0
- Time complexity:
- O(1)
- ACL categories:
-
@keyspace
,@write
,@fast
,
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 since Redis 7.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
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
RESP2/RESP3 Reply
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.
History
- Starting with Redis version 7.0.0: Added options:
NX
,XX
,GT
andLT
.