TTL命令表示以秒为单位,返回指定key的剩余生存时间。
命令格式
TTL key
可用版本:>=1.0.0
时间复杂度:O(1)
命令返回值
TTL命令返回有3种情况:
- 返回-2,当指定的key不存在时。
- 返回-1,当指定的key存在,但没有设置生存时间时。
- 返回正整数,即返回key的剩余生存时间,单位为秒。
在2.6版本,当指定key不存在或没有设置生存时间时,都返回-1。
从2.8版本及之后,当指定的key不存在时,返回-2,而指定的key存在但没有设置生存时间时返回-1。
示例
redis> TTL mystring # 指定key不存在,返回-2
(integer) -2
redis> SET mystring hello
OK
redis> TTL mystring # 指定key存在但没有设置剩余生存时间,返回-1
(integer) -1
redis> EXPIRE mystring 10
(integer) 1
redis> TTL mystring # 返回正常的剩余生存时间,单位为秒
(integer) 7