PTTL

返回键的过期时间（以毫秒为单位）。

语法

PTTL key

引入版本：2.6.0

复杂度摘要：O(1)

与 TTL 类似，此命令返回设置了过期时间的键的剩余生存时间，唯一的区别是 TTL 以秒为单位返回剩余时间，而 PTTL 以毫秒为单位返回剩余时间。

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

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

  • 如果键不存在，该命令返回-2。
  • 如果键存在但没有关联的过期时间，则该命令返回 -1。

必需参数

key

键名称。

示例

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

Redis Software 与 Redis Cloud 兼容性

Redis
软件		 Redis
Cloud		 说明
✅ 标准
✅ 主动-主动		 ✅ 标准
✅ 主动-主动

返回值

RESP2

以下之一： * 整数回复：TTL（以毫秒为单位）。 * 整数回复：如果键存在但没有关联的过期时间，则为 -1。 * 整数回复：如果键不存在则为-2。

RESP3

以下之一： * 整数回复：TTL（以毫秒为单位）。 * 整数回复：如果键存在但没有关联的过期时间，则为 -1。 * 整数回复：如果键不存在则为-2。

资料来源：Redis 官方 PTTL 文档；中文内容参考 Redis 文档许可。