# HPEXPIRETIME

> Get the absolute expiry time of hash fields as a Unix time in milliseconds.

URL: https://docs.hotkv.com/commands/hpexpiretime/

```
HPEXPIRETIME key FIELDS numfields field [field ...]
```

- Group: Hash
- Complexity: O(N) where N is the number of fields given
- HotKV Cloud: all plans
- On-Premise: no license needed

`HPEXPIRETIME` works like [HEXPIRETIME](https://docs.hotkv.com/commands/hexpiretime/index.md), but returns
each field's expiry as a Unix timestamp in milliseconds.

## Return value

An array with one integer per field, in the order given, under both RESP2 and
RESP3:

| Value | Meaning |
| --- | --- |
| `-2` | The field or the key does not exist. |
| `-1` | The field exists but has no expiry. |
| Positive integer | The expiry as a Unix time in milliseconds. |

The errors are the same as for [HTTL](https://docs.hotkv.com/commands/httl/index.md).

## Examples

```
127.0.0.1:6379> HSET promo:3 code "SPRING"
(integer) 1
127.0.0.1:6379> HPEXPIREAT promo:3 1924992000500 FIELDS 1 code
1) (integer) 1
127.0.0.1:6379> HPEXPIRETIME promo:3 FIELDS 1 code
1) (integer) 1924992000500
```

## Compatibility

Same as Redis 7.4. Valkey 8 does not have hash field expiration.

## See also

[HEXPIRETIME](https://docs.hotkv.com/commands/hexpiretime/index.md), [HPEXPIREAT](https://docs.hotkv.com/commands/hpexpireat/index.md), [HPTTL](https://docs.hotkv.com/commands/hpttl/index.md),
[PEXPIRETIME](https://docs.hotkv.com/commands/pexpiretime/index.md)