API documentation of EXPIRETIME and PEXPIRETIME commands

commands.json

@@ -1244,6 +1244,18 @@
     "since": "1.2.0",
     "group": "generic"
   },
+  "EXPIRETIME": {
+    "summary": "Get the expiration Unix timestamp for a key",
+    "complexity": "O(1)",
+    "arguments": [
+      {
+        "name": "key",
+        "type": "key"
+      }
+    ],
+    "since": "7.0.0",
+    "group": "generic"
+  },
   "FAILOVER": {
     "summary": "Start a coordinated failover between this server and one of its replicas.",
     "arguments": [
@@ -2864,6 +2876,18 @@
     "since": "2.6.0",
     "group": "generic"
   },
+  "PEXPIRETIME": {
+    "summary": "Get the expiration Unix timestamp for a key in milliseconds",
+    "complexity": "O(1)",
+    "arguments": [
+      {
+        "name": "key",
+        "type": "key"
+      }
+    ],
+    "since": "7.0.0",
+    "group": "generic"
+  },
   "PFADD": {
     "summary": "Adds the specified elements to the specified HyperLogLog.",
     "complexity": "O(1) to add every element.",

commands/expiretime.md

@@ -0,0 +1,17 @@
+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
+```

commands/pexpiretime.md

@@ -0,0 +1,15 @@
+`PEXPIRETIME` has the same semantic as `EXPIRETIME`, but returns the absolute Unix expiration timestamp in milliseconds instead of seconds.
+
+@return
+
+@integer-reply: Expiration Unix timestamp in milliseconds, 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"
+PEXPIREAT mykey 33177117420000
+PEXPIRETIME mykey
+```