expiretime.3valkey - Man Page
Returns the expiration time of a key as a Unix timestamp.
Synopsis
EXPIRETIME
key
Description
Returns the absolute Unix timestamp (since January 1, 1970) in seconds at which the given key will expire.
See also the PEXPIRETIME
command which returns the same information with milliseconds resolution.
Reply
One of the following:
- valkey-protocol(7) Integer reply: the expiration Unix timestamp in seconds.
- valkey-protocol(7) Integer reply:
-1
if the key exists but has no associated expiration time. - valkey-protocol(7) Integer reply:
-2
if the key does not exist.
Complexity
O(1)
Acl Categories
@fast @keyspace @read
History
- Available since: 7.0.0
Examples
127.0.0.1:6379> SET mykey "Hello" OK 127.0.0.1:6379> EXPIREAT mykey 33177117420 (integer) 1 127.0.0.1:6379> EXPIRETIME mykey (integer) 33177117420
See Also
copy(3valkey), del(3valkey), dump(3valkey), exists(3valkey), expire(3valkey), expireat(3valkey), keys(3valkey), migrate(3valkey), move(3valkey), object(3valkey), object-encoding(3valkey), object-freq(3valkey), object-help(3valkey), object-idletime(3valkey), object-refcount(3valkey), persist(3valkey), pexpire(3valkey), pexpireat(3valkey), pexpiretime(3valkey), pttl(3valkey), randomkey(3valkey), rename(3valkey), renamenx(3valkey), restore(3valkey), scan(3valkey), sort(3valkey), sort_ro(3valkey), touch(3valkey), ttl(3valkey), type(3valkey), unlink(3valkey), wait(3valkey), waitaof(3valkey)