summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/expiretime.md
blob: 1c4c815c34b0c2e4431ea86898e01ae5f523e92a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
Returns the absolute Unix timestamp (since January 1, 1970) in seconds at which
the given key will expire.

See also the `PEXPIRETIME` command which returns the same information with
milliseconds resolution.

@return

@integer-reply: Expiration Unix timestamp in seconds, or a negative value in
order to signal an error (see the description below).

- The command returns `-1` if the key exists but has no associated expiration
  time.
- The command returns `-2` if the key does not exist.

@examples

```cli
SET mykey "Hello"
EXPIREAT mykey 33177117420
EXPIRETIME mykey
```