expireat.3valkey - Man Page

EXPIREAT key unix-time-seconds [NX | XX | GT | LT]

EXPIREAT has the same effect and semantic as EXPIRE, but instead of specifying the number of seconds representing the TTL (time to live), it takes an absolute Unix timestamp\c  (seconds since January 1, 1970). A timestamp in the past will delete the key immediately.

Please for the specific semantics of the command refer to the documentation of EXPIRE.

The EXPIREAT command supports a set of options:

• NX – Set expiry only when the key has no expiry
• XX – Set expiry only when the key has an existing expiry
• GT – Set expiry only when the new expiry is greater than current one
• LT – Set expiry only when the new expiry is less than current one

A non-volatile key is treated as an infinite TTL for the purpose of GT and LT. The GT, LT and NX options are mutually exclusive.

One of the following:

• valkey-protocol(7) Integer reply: 0 if the timeout was not set; for example, the key doesn’t exist, or the operation was skipped because of the provided arguments.
• valkey-protocol(7) Integer reply: 1 if the timeout was set.

O(1)

@fast @keyspace @write

• Available since: 1.2.0
• Changed in 7.0.0: Added options: NX, XX, GT and LT.

127.0.0.1:6379> SET mykey "Hello"
OK
127.0.0.1:6379> EXISTS mykey
(integer) 1
127.0.0.1:6379> EXPIREAT mykey 1293840000
(integer) 1
127.0.0.1:6379> EXISTS mykey
(integer) 0

copy(3valkey), del(3valkey), dump(3valkey), exists(3valkey), expire(3valkey), expiretime(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)