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 valkey-pexpiretime(7) 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:
-1if the key exists but has no associated expiration time. - valkey-protocol(7) Integer reply:
-2if 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)