返回具有超时时间的键的剩余生存时间。 这种自省功能允许Redis客户端检查给定键将继续留存在数据库中的秒数。
在Redis 2.6或更早版本中,如果键不存在或键存在但没有关联的过期时间,则命令返回-1
。
从Redis 2.8开始,如果发生错误,则返回值:
- 如果键不存在,则命令返回
-2
。 - 如果键存在但没有关联的过期时间,则命令返回
-1
。
另请参阅PTTL命令,该命令以毫秒的精度返回相同的信息(仅在Redis 2.6或更高版本中可用)。
可用版本:从1.0.0开始可用
时间复杂度:O(1)
命令格式
TTL key
示例
redis> SET mykey "Hello"
"OK"
redis> EXPIRE mykey 10
(integer) 1
redis> TTL mykey
(integer) 10
返回值
TTL(以秒为单位),或负值以表示错误(请参见上面的描述)。