Hash

HEXPIRETIME

Retrieves the expiration time of field(s) in a hash in seconds.

Arguments

keybodystringrequired

The key of the hash.

fieldsbodystring | number | (string | number)[]required

The field(s) to retrieve the expiration time for.

Response

number[]required

The expiration time in seconds since the Unix epoch for each field.

  • -2 if the field does not exist in the hash or if the key doesn't exist.
  • -1 if the field exists but has no associated expiration.

For more details, see HEXPIRETIME documentation.

Example
await redis.hset("my-key", "my-field", "my-value");await redis.hexpireat("my-key", "my-field", Math.floor(Date.now() / 1000) + 10);const expireTime = await redis.hexpiretime("my-key", "my-field");console.log(expireTime); // e.g., [1697059200]
Loading search…