Redis 基础教程

Redis 命令

Redis 高级教程

Redis 笔记

original icon
版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.knowledgedict.com/tutorial/redis-command-pttl.html

Redis PTTL 命令

Redis 键(Keys) Redis 键(Keys)


PTTL命令类似于TTL命令,但它以毫秒为单位返回key的剩余生存时间,而不是像TTL命令那样,以秒为单位。

命令格式

PTTL key

可用版本:>=2.6.0

时间复杂度:O(1)

命令返回值

PTTL命令返回有3种情况:

  • 返回-2,当指定的key不存在时。
  • 返回-1,当指定的key存在,但没有设置生存时间时。
  • 返回正整数,即返回key的剩余生存时间,单位为毫秒。

在2.6版本,当指定key不存在或没有设置生存时间时,都返回-1。

从2.8版本及之后,当指定的key不存在时,返回-2,而指定的key存在但没有设置生存时间时返回-1。

示例

redis> PTTL mystring        # 指定key不存在,返回-2
(integer) -2
redis> SET mystring hello
OK
redis> PTTL mystring        # 指定key存在但没有设置剩余生存时间,返回-1
(integer) -1
redis> EXPIRE mystring 10
(integer) 1
redis> PTTL mystring        # 返回正常的剩余生存时间,单位为毫秒
(integer) 7160