TTL

TTL key

可用时间

1.0.0

时间复杂度

O(1)

ACL 类别

@keyspace, @read, @fast,

返回具有超时设置的键的剩余生存时间。此自省功能允许 Redis 客户端检查给定键将在数据集中保留多长时间。

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

从 Redis 2.8 开始，错误情况下的返回值已更改

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

另请参阅 PTTL 命令，该命令返回具有毫秒级精度的相同信息（仅在 Redis 2.6 或更高版本中可用）。

示例

RESP2/RESP3 响应

以下之一

• 整数响应: 以秒为单位的 TTL。
• 整数响应: 如果键存在但没有关联的过期时间，则为 -1。
• 整数响应: 如果键不存在，则为 -2。

历史记录

• 从 Redis 2.8.0 版本开始：添加了 -2 响应。