PEXPIRE

Syntax text Syntax diagram API methods

PEXPIRE key milliseconds [NX | XX | GT | LT]

Client:

pexpire(
    name: KeyT,
    time: ExpiryT,
    nx: bool,
    xx: bool,
    gt: bool,
    lt: bool
) → int

PEXPIRE(
    key: RedisArgument,
    milliseconds: number,
    mode?: 'NX' | 'XX' | 'GT' | 'LT'
) → Any

pexpire(
    key: byte[],
    milliseconds: long  // time to expire
) → long  // 1 if the timeout was set, 0 otherwise

pexpire(
    key: byte[],
    milliseconds: long,  // time to expire
    expiryOption: ExpiryOption  // can be NX, XX, GT or LT
) → long  // 1 if the timeout was set, 0 otherwise

pexpire(
    key: String,
    milliseconds: long  // time to expire
) → long  // 1 if the timeout was set, 0 otherwise

pexpire(
    key: String,
    milliseconds: long,  // time to expire
    expiryOption: ExpiryOption  // can be NX, XX, GT or LT
) → long  // 1 if the timeout was set, 0 otherwise

pexpire(
    key: K,  // the key.
    milliseconds: long  // the milliseconds.
) → Boolean  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: long,  // the milliseconds.
    expireArgs: ExpireArgs  // the expiry arguments.
) → Boolean  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: Duration  // the milliseconds.
) → Boolean  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: Duration,  // the milliseconds.
    expireArgs: ExpireArgs  // the expiry arguments.
) → Boolean  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: long  // the milliseconds.
) → RedisFuture<Boolean>  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: long,  // the milliseconds.
    expireArgs: ExpireArgs  // the expiry arguments.
) → RedisFuture<Boolean>  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: Duration  // the milliseconds.
) → RedisFuture<Boolean>  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: Duration,  // the milliseconds.
    expireArgs: ExpireArgs  // the expiry arguments.
) → RedisFuture<Boolean>  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: long  // the milliseconds.
) → Mono<Boolean>  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: long,  // the milliseconds.
    expireArgs: ExpireArgs  // the expiry arguments.
) → Mono<Boolean>  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: Duration  // the milliseconds.
) → Mono<Boolean>  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    key: K,  // the key.
    milliseconds: Duration,  // the milliseconds.
    expireArgs: ExpireArgs  // the expiry arguments.
) → Mono<Boolean>  // Boolean integer-reply specifically: true if the timeout was set. false if key does not exist or the timeout could not be set.

PExpire(
    ctx: context.Context,
    key: string,
    expiration: time.Duration
) → *BoolCmd

KeyExpire(
    key: RedisKey,  // The key to set the expiration for.
    expiry: TimeSpan?,  // The timeout to set.
    when: ExpireWhen,  // In Redis 7+, we choose under which condition the expiration will be set using ExpireWhen.
    flags: CommandFlags  // The flags to use for this operation.
) → bool  // true if the timeout was set. false if key does not exist or the timeout could not be set.

KeyExpireAsync(
    key: RedisKey,  // The key to set the expiration for.
    expiry: TimeSpan?,  // The timeout to set.
    when: ExpireWhen,  // In Redis 7+, we choose under which condition the expiration will be set using ExpireWhen.
    flags: CommandFlags  // The flags to use for this operation.
) → Task<bool>  // true if the timeout was set. false if key does not exist or the timeout could not be set.

pexpire(
    $key: string,
    $milliseconds: int,
    $expireOption: string
) → int

Available since:: Redis Open Source 2.6.0
Time complexity:: O(1)
ACL categories:: @keyspace, @write, @fast,
Compatibility:: Redis Software and Redis Cloud compatibility

This command works exactly like EXPIRE but the time to live of the key is specified in milliseconds instead of seconds.

Required arguments

key

The name of the key to set a timeout on.

milliseconds

The timeout, in milliseconds.

Optional arguments

The following options modify the command's behavior. They are mutually exclusive.

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 the current one. A non-volatile key is treated as an infinite TTL for the purpose of GT.

LT

Set expiry only when the new expiry is less than the current one. A non-volatile key is treated as an infinite TTL for the purpose of LT.

Examples

Redis Software and Redis Cloud compatibility

Redis Software	Redis Cloud	Notes
✅ Standard ✅ Active-Active	✅ Standard ✅ Active-Active

Return information

RESP2 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.

History

Starting with Redis version 7.0.0: Added options: NX, XX, GT and LT.