Hash
HEXPIREAT
Sets an expiration time for field(s) in a hash in seconds since the Unix epoch.
Arguments
keybodystrrequired
The key of the hash.
fieldsbodyUnion[str, List[str]]required
The field or list of fields to set an expiration time for.
timestampbodyintrequired
The expiration time as a Unix timestamp in seconds.
nxbodybool
Set expiry only when the field has no expiry. Defaults to False.
xxbodybool
Set expiry only when the field has an existing expiry. Defaults to False.
gtbodybool
Set expiry only when the new expiry is greater than the current one. Defaults to False.
ltbodybool
Set expiry only when the new expiry is less than the current one. Defaults to False.
Response
List[int]required
A list of integers indicating whether the expiry was successfully set.
-2if the field does not exist in the hash or if the key doesn't exist.0if the expiration was not set due to the condition.1if the expiration was successfully set.2if called with 0 seconds/milliseconds or a past Unix time.
For more details, see HEXPIREAT documentation.
Example
redis.hset(hash_name, field, value)assert redis.hexpireat(hash_name, field, int(time.time()) + 10) == [1]