PEXPIRE

This command works exactly like [EXPIRE]({{< relref "/commands/expire" >}}) but the time to live of the key is specified in milliseconds instead of seconds.

Options

The PEXPIRE command supports a set of options since Redis 7.0:

• NX -- Set expiry only when the key has no expiry
• XX -- Set expiry only when the key has an existing expiry
• GT -- Set expiry only when the new expiry is greater than current one
• LT -- Set expiry only when the new expiry is less than current one

A non-volatile key is treated as an infinite TTL for the purpose of GT and LT. The GT, LT and NX options are mutually exclusive.

Examples

{{% redis-cli %}} SET mykey "Hello" PEXPIRE mykey 1500 TTL mykey PTTL mykey PEXPIRE mykey 1000 XX TTL mykey PEXPIRE mykey 1000 NX TTL mykey {{% /redis-cli %}}

Redis Software and Redis Cloud compatibility

| Redis Software | Redis Cloud | <span style="min-width: 9em; display: table-cell">Notes</span> | |:----------------------|:-----------------|:------| | <span title="Supported">✅ Standard</span> <span title="Supported"><nobr>✅ Active-Active</nobr></span> | <span title="Supported">✅ Standard</span> <span title="Supported"><nobr>✅ Active-Active</nobr></span> | |

Return information

{{< multitabs id="pexpire-return-info" tab1="RESP2" tab2="RESP3" >}}

One of the following:

• Integer reply: 0 if the timeout was not set. For example, if the key doesn't exist, or the operation skipped because of the provided arguments.
• Integer reply: 1 if the timeout was set.

-tab-sep-

One of the following:

• Integer reply: 0 if the timeout was not set. For example, if the key doesn't exist, or the operation skipped because of the provided arguments.
• Integer reply: 1 if the timeout was set.

{{< /multitabs >}}