TTL

Usage:

TTL key

Complexity:

O(1)

Since:

1.0.0

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

The command returns the following valueis in case of errors:

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

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

Examples

SET mykey "Hello"
EXPIRE mykey 10
TTL mykey

History