# TTL

以秒为单位获得key的使用时间

语法

TTL key
  • 可用版本:

    1.0.0

  • 时间复杂度:

    O(1)

  • ACL 类别:

    @keyspace, @read, @fast

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

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

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

  • -2如果密钥不存在,该命令将返回。
  • -1如果密钥存在但没有关联的过期,则该命令返回。

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

# 返回

整数:以秒为单位的 TTL,或负值以指示错误(请参阅上面的描述)。

# 例子

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

# 历史

  • 从 Redis 版本 2.8.0 开始:添加了 -2 回复。

# 反馈

如果您在此页面上发现问题,或有改进建议,请提交请求以合并或打开存储库中的问题。

Last Updated: 4/18/2023, 8:45:33 AM