PTTL
Syntax
PTTL key
- Available since:
- 2.6.0
- Time complexity:
- O(1)
- ACL categories:
-
@keyspace
,@read
,@fast
,
与TTL
类似,此命令返回设置了过期时间的键的剩余生存时间,唯一的区别是TTL
返回剩余时间的秒数,而PTTL
返回的是毫秒数。
在 Redis 2.6 或更早版本中,如果键不存在或键存在但没有关联的过期时间,命令将返回 -1
。
从 Redis 2.8 开始,错误情况下的返回值发生了变化:
- 如果键不存在,命令返回
-2
。 - 如果键存在但没有关联的过期时间,命令返回
-1
。
示例
RESP2/RESP3 回复
以下之一:
- Integer reply: 以毫秒为单位的TTL。
- Integer reply:
-1
如果键存在但没有关联的过期时间。 - Integer reply:
-2
如果键不存在。
历史
- 从 Redis 版本 2.8.0 开始:添加了 -2 回复。