await redis.hset("my-key", "my-field", "my-value");
const expirationSet = await redis.hexpireat("my-key", "my-field", Math.floor(Date.now() / 1000) + 10);

console.log(expirationSet); // [1]

​
Arguments

​
key
string
required

The key of the hash.

​
fields
string | number | (string | number)[]
required

The field(s) to set an expiration time for.

​
timestamp
number
required

The expiration time as a Unix timestamp in seconds.

​
option
string

Optional condition for setting the expiration:

  • NX: Set the expiration only if the field does not already have an expiration.
  • XX: Set the expiration only if the field already has an expiration.
  • GT: Set the expiration only if the new TTL is greater than the current TTL.
  • LT: Set the expiration only if the new TTL is less than the current TTL.

​
Response

A list of integers indicating whether the expiry was successfully set.

  • -2 if the field does not exist in the hash or if key doesn’t exist.
  • 0 if the expiration was not set due to the condition.
  • 1 if the expiration was successfully set.
  • 2 if called with 0 seconds/milliseconds or a past Unix time.

For more details, see HEXPIREAT documentation.

await redis.hset("my-key", "my-field", "my-value");
const expirationSet = await redis.hexpireat("my-key", "my-field", Math.floor(Date.now() / 1000) + 10);

console.log(expirationSet); // [1]

Was this page helpful?

Suggest editsRaise issue