游戏开发工具

PTTL命令

92 篇文章68 次收藏
上一节:PSETEX命令下一节:RANDOMKEY命令

获取key的生存时间(毫秒)

语法

PTTL key


  • 可用版本:

    2.6.0

  • 时间复杂度:

    O(1)

  • ACL 类别:

    @keyspace@read@fast

与 TTL 此命令一样,该命令返回设置了过期时间的密钥的剩余生存时间,唯一的区别 TTL 是以秒为单位返回剩余时间量,而PTTL以毫秒为单位返回剩余时间。

在 Redis 2.6 或更早版本中,-1如果密钥不存在或密钥存在但没有关联的过期时间,则该命令返回。

从 Redis 2.8 开始,发生错误时的返回值发生了变化:

  • -2如果密钥不存在,该命令将返回。

  • -1如果密钥存在但没有关联的过期,则该命令返回。

#返回

整数:以毫秒为单位的 TTL,或负值以指示错误(请参阅上面的描述)。

#例子

例子如下:

redis> SET mykey "Hello"
"OK"
redis> EXPIRE mykey 1
(integer) 1
redis> PTTL mykey
(integer) 1000
redis>


例子描述如上所述。


#历史

  • 从 Redis 版本 2.8.0 开始:添加了 -2 回复。



上一节:PSETEX命令下一节:RANDOMKEY命令