查看“Keys pttl”的源代码

{{DISPLAYTITLE:PTTL key}}[[Category:redis keys|11]]
= Redis Pttl 命令 =

[[redis keys|Redis key(键)]]

Redis Pttl 命令以毫秒为单位返回 key 的剩余过期时间。

=== 语法 ===

redis Pttl 命令基本语法如下：

<sample title="" desc="" lang="redis" hererun="1">
redis 127.0.0.1:6379> PTTL KEY_NAME
 </sample>
=== 可用版本 ===

&gt;= 2.6.0

=== 返回值 ===

当 key 不存在时，返回 -2 。 当 key 存在但没有设置剩余生存时间时，返回 -1 。 否则，以毫秒为单位，返回 key 的剩余生存时间。

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

==

<sample title="" desc="" lang="redis" hererun="1">
# 不存在的 key

redis> FLUSHDB
OK

redis> PTTL key
(integer) -2

# key 存在，但没有设置剩余生存时间

redis> SET key value
OK

redis> PTTL key
(integer) -1

# 有剩余生存时间的 key

redis> PEXPIRE key 10086
(integer) 1

redis> PTTL key
(integer) 6179
 </sample>
[[redis keys|Redis key(键)]]