TTL

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

语法

TTL key

引入版本：1.0.0

复杂度摘要：O(1)

返回超时的键的剩余生存时间。这种自省功能允许 Redis 客户端检查给定键将继续作为数据集的一部分的秒数。

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

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

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

另请参阅 PTTL 命令，该命令以毫秒分辨率返回相同信息（仅在 Redis 2.6 或更高版本中可用）。

必需参数

key

键名称。

示例

> SET mykey "Hello"
OK
> EXPIRE mykey 10
(integer) 1
> TTL mykey
(integer) 10

Redis Software 与 Redis Cloud 兼容性

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

返回值

RESP2

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

RESP3

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

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