GETEX key [EX seconds|PX milliseconds|EXAT unix-time-seconds|PXAT unix-time-milliseconds|PERSIST]
Available since: 6.2.0
Time complexity: O(1)
ACL categories:
@write
@string
@fast
Get the value of key
and optionally set its expiration.
GETEX
is similar to GET
, but is a write command with additional options.
Options
The GETEX
command supports a set of options that modify its behavior:
EX
seconds – Set the specified expire time, in seconds.PX
milliseconds – Set the specified expire time, in milliseconds.EXAT
timestamp-seconds – Set the specified Unix time at which the key will expire, in seconds.PXAT
timestamp-milliseconds – Set the specified Unix time at which the key will expire, in milliseconds.PERSIST
– Remove the time to live associated with the key.
@return
@bulk-string-reply: the value of key
, or nil
when key
does not exist.
@examples
redis> SET mykey "Hello"
TBD
redis> GETEX mykey
TBD
redis> TTL mykey
TBD
redis> GETEX mykey EX 60
TBD
redis> TTL mykey