summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/expiretime.md
blob: b524dcc34f207daf8c4cbbee884203097713d5ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
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
```