Skip to content
HotKVDocs

Ask the HotKV docs

Answers come only from these docs and can be wrong; check the linked pages before you rely on them.

TTL

Last updated 
TTL key
Group
Keys
Complexity
O(1)
Arity
2 (exactly, counting the command name)
Flags
read-only, fast
Keys
first 1, last 1, step 1
HotKV Cloud
All plans
On-Premise
no license needed

TTL returns how many seconds are left before key expires, rounded to the nearest second, so a TTL right after EXPIRE key 100 reads 100. Reading the time to live is not an access to the key.

Return value

Section titled “Return value”
Case RESP2 RESP3
The key has a time to live Integer: seconds left Integer
The key exists without a time to live Integer -1 Integer -1
The key does not exist Integer -2 Integer -2

Examples

Section titled “Examples”
127.0.0.1:6379> SET token "x" EX 30
OK
127.0.0.1:6379> TTL token
(integer) 30
127.0.0.1:6379> SET plain "y"
OK
127.0.0.1:6379> TTL plain
(integer) -1
127.0.0.1:6379> TTL missing
(integer) -2

Compatibility

Section titled “Compatibility”

Same as Redis 7 and Valkey 8.

See also

Section titled “See also”

PTTL, NTTL, EXPIRETIME, EXPIRE