PTTL key

可用版本： >= 2.6.0
复杂度： O(1)

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

返回值

  • 当 key 不存在时，返回 -2 。

  • 当 key 存在但没有设置剩余生存时间时，返回 -1 。

  • 否则，以毫秒为单位，返回 key 的剩余生存时间。

Note

在 Redis 2.8 以前，当 key 不存在，或者 key 没有设置剩余生存时间时，命令都返回 -1 。

代码示例

  1. # 不存在的 key
  2.  
  3. redis> FLUSHDB
  4. OK
  5.  
  6. redis> PTTL key
  7. (integer) -2
  8.  
  9.  
  10. # key 存在，但没有设置剩余生存时间
  11.  
  12. redis> SET key value
  13. OK
  14.  
  15. redis> PTTL key
  16. (integer) -1
  17.  
  18.  
  19. # 有剩余生存时间的 key
  20.  
  21. redis> PEXPIRE key 10086
  22. (integer) 1
  23.  
  24. redis> PTTL key
  25. (integer) 6179