PTTL
Syntax
PTTL key
- Available since:
- 2.6.0
- Time complexity:
- O(1)
- ACL categories:
-
@keyspace
,@read
,@fast
,
Like TTL
this command returns the remaining time to live of a key that has an
expire set, with the sole difference that TTL
returns the amount of remaining
time in seconds while PTTL
returns it in milliseconds.
In Redis 2.6 or older the command returns -1
if the key does not exist or if the key exist but has no associated expire.
Starting with Redis 2.8 the return value in case of error changed:
- The command returns
-2
if the key does not exist. - The command returns
-1
if the key exists but has no associated expire.
Examples
RESP2/RESP3 Reply
One of the following:
- Integer reply: TTL in milliseconds.
- Integer reply:
-1
if the key exists but has no associated expiration. - Integer reply:
-2
if the key does not exist.
History
- Starting with Redis version 2.8.0: Added the -2 reply.