Skip to content
This repository has been archived by the owner on May 14, 2024. It is now read-only.
Josh Baker edited this page Oct 10, 2016 · 7 revisions

TTL key

Returns the remaining time to live of a key that has a timeout. This introspection capability allows a Redis client to check how many seconds a given key will continue to be part of the dataset.

See also the PTTL command that returns the same information with milliseconds resolution.

Return value

Integer reply: TTL in seconds, or a negative value in order to signal an error:

  • -2 if the key does not exist.
  • -1 if the key exists but has no associated expire.

Examples

redis> SET mykey "Hello"
OK
redis> EXPIRE mykey 10
(integer) 1
redis> TTL mykey
(integer) 10
Clone this wiki locally