{"id":26152,"date":"2022-06-23T12:00:41","date_gmt":"2022-06-23T02:00:41","guid":{"rendered":"https:\/\/database.guide\/?p=26152"},"modified":"2022-06-27T11:58:18","modified_gmt":"2022-06-27T01:58:18","slug":"redis-pexpire-command-explained","status":"publish","type":"post","link":"https:\/\/database.guide\/redis-pexpire-command-explained\/","title":{"rendered":"Redis PEXPIRE Command Explained"},"content":{"rendered":"\n

The Redis PEXPIRE<\/code> command sets a timeout on a given key in milliseconds. After the timeout has expired, the key will be deleted.<\/p>\n\n\n\n

The PEXPIRE<\/code> command works exactly the same as the EXPIRE<\/a><\/code> command, except that it returns the timeout in milliseconds instead of seconds.<\/p>\n\n\n\n\n\n\n\n

Syntax<\/h2>\n\n\n\n

The syntax goes like this:<\/p>\n\n\n\n

PEXPIRE key milliseconds [ NX | XX | GT | LT]<\/code><\/pre>\n\n\n\n
Explanation of arguments:<\/p>\n\n\n\n
key<\/code><\/td>The key for which to set the timeout.<\/td><\/tr>
milliseconds<\/code><\/td>The number of milliseconds for the timeout.<\/td><\/tr>
NX<\/code><\/td>Sets an expiry only when the key has no expiry.<\/td><\/tr>
XX<\/code><\/td>Sets an expiry only when the key has an existing expiry.<\/td><\/tr>
GT<\/code><\/td>Sets an expiry only when the new expiry is greater than current one.<\/td><\/tr>
LT<\/code><\/td>Sets an expiry only when the new expiry is less than current one.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
The NX<\/code>, XX<\/code>, GT<\/code>, and LT<\/code> arguments were introduced in Redis 7.0.0.<\/p>\n\n\n\n
Example<\/h2>\n\n\n\n
Suppose we set a key:<\/p>\n\n\n\n
SET breakfast \"Muesli\"<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
OK<\/pre>\n\n\n\n
We didn’t set an expiry for this key, so when I run the PTTL command against it:<\/p>\n\n\n\n
PTTL breakfast<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) -1<\/pre>\n\n\n\n
We get an integer reply of -1<\/code> (which means it has no expiry).<\/p>\n\n\n\n
The PTTL<\/a><\/code> command returns a key’s time to live in milliseconds. We can alternatively use the TTL<\/a><\/code> command to return the time to live in seconds.<\/p>\n\n\n\n
Now let’s use PEXPIRE<\/code> to set an expiry:<\/p>\n\n\n\n
PEXPIRE breakfast 86400000<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 1<\/pre>\n\n\n\n
We got an integer reply of 1<\/code>, which means it was successful. <\/p>\n\n\n\n
Let’s check its time to live:<\/p>\n\n\n\n
PTTL breakfast<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 86351862<\/pre>\n\n\n\n
We still have plenty of time left before it expires.<\/p>\n\n\n\n
We can also use the PEXPIRETIME<\/a><\/code> command to get the absolute Unix time of its expiry. <\/p>\n\n\n\n
PEXPIRETIME breakfast<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 1655978136926<\/pre>\n\n\n\n
The EXPIRETIME<\/a><\/code> command does the same thing, but returns the result in seconds.<\/p>\n\n\n\n
The NX<\/code> Argument<\/h2>\n\n\n\n
The NX<\/code> argument was introduced in Redis 7.0.0. <\/p>\n\n\n\n
We can use the NX<\/code> argument to set the timeout only if the key doesn’t already have an expiry. <\/p>\n\n\n\n
To demonstrate this, let’s first try to set the expiry on the key that we used in the previous example:<\/p>\n\n\n\n
PEXPIRE breakfast 100000000 NX<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 0<\/pre>\n\n\n\n
It doesn’t work. We get an integer reply of 0<\/code>, which means that the timeout wasn’t set.<\/p>\n\n\n\n
Let’s remove the expiry:<\/p>\n\n\n\n
PERSIST breakfast<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 1<\/pre>\n\n\n\n
And try again:<\/p>\n\n\n\n
PEXPIRE breakfast 100000000 NX<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 1<\/pre>\n\n\n\n
This time we were successful.<\/p>\n\n\n\n
Let’s check the time to live:<\/p>\n\n\n\n
PTTL breakfast<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 99988589<\/pre>\n\n\n\n
Yes, it worked as expected.<\/p>\n\n\n\n
The XX<\/code> Argument<\/h2>\n\n\n\n
The XX<\/code> argument was introduced in Redis 7.0.0. <\/p>\n\n\n\n
We can use the XX<\/code> argument to set the timeout only if the key already has an expiry.<\/p>\n\n\n\n
Let’s try updating the same key from the previous examples:<\/p>\n\n\n\n
PEXPIRE breakfast 500000000 XX<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 1<\/pre>\n\n\n\n
Looks like it worked. <\/p>\n\n\n\n
Let’s use PTTL<\/code> to check the current time to live:<\/p>\n\n\n\n
PTTL breakfast<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 499969158<\/pre>\n\n\n\n
Looks good.<\/p>\n\n\n\n
The GT<\/code> Argument<\/h2>\n\n\n\n
The GT<\/code> argument was introduced in Redis 7.0.0. <\/p>\n\n\n\n
We can use the GT<\/code> argument to set the timeout only if the new expiry is greater than current one.<\/p>\n\n\n\n
To test this, let’s try updating our key with a smaller timeout:<\/p>\n\n\n\n
PEXPIRE breakfast 400000000 GT<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 0<\/pre>\n\n\n\n
It didn’t work, because the new expiry is smaller than the current one.<\/p>\n\n\n\n
Let’s try again, with a larger expiry:<\/p>\n\n\n\n
PEXPIRE breakfast 500000000 GT<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 1<\/pre>\n\n\n\n
This time it worked, because our expiry is greater than the current one.<\/p>\n\n\n\n
Note that my new expiry is the same as the 500000000 that I had previously used to set the timeout. However, time has elapsed since then, and the time to live has therefore decreased. Therefore, my new value happens to be higher than the current time to live.<\/p>\n\n\n\n
The LT<\/code> Argument<\/h2>\n\n\n\n
The LT<\/code> argument was introduced in Redis 7.0.0. <\/p>\n\n\n\n
We can use the LT<\/code> argument to set the timeout only if the new expiry is less than current one.<\/p>\n\n\n\n
To test this, let’s try updating our key with a larger timeout:<\/p>\n\n\n\n
PEXPIRE breakfast 600000000 LT<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 0<\/pre>\n\n\n\n
It didn’t work, because the new expiry is larger than the current one.<\/p>\n\n\n\n
Let’s try again, with a smaller expiry:<\/p>\n\n\n\n
PEXPIRE breakfast 400000000 LT<\/code><\/pre>\n\n\n\n
Result:<\/p>\n\n\n\n
(integer) 1<\/pre>\n\n\n\n
This time it worked, because our expiry is less than the current one.<\/p>\n","protected":false},"excerpt":{"rendered":"
The Redis PEXPIRE command sets a timeout on a given key in milliseconds. After the timeout has expired, the key will be deleted. The PEXPIRE command works exactly the same as the EXPIRE command, except that it returns the timeout in milliseconds instead of seconds.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[153],"tags":[154,20],"class_list":["post-26152","post","type-post","status-publish","format-standard","hentry","category-redis","tag-commands","tag-what-is"],"_links":{"self":[{"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/posts\/26152","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/comments?post=26152"}],"version-history":[{"count":5,"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/posts\/26152\/revisions"}],"predecessor-version":[{"id":26262,"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/posts\/26152\/revisions\/26262"}],"wp:attachment":[{"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/media?parent=26152"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/categories?post=26152"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/database.guide\/wp-json\/wp\/v2\/tags?post=26152"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}