Back to Redis

DECRBY

content/commands/decrby.md

latest1.3 KB
Original Source

The DECRBY command reduces the value stored at the specified key by the specified decrement. If the key does not exist, it is initialized with a value of 0 before performing the operation. If the key's value is not of the correct type or cannot be represented as an integer, an error is returned. This operation is limited to 64-bit signed integers.

See [INCR]({{< relref "/commands/incr" >}}) for extra information on increment/decrement operations.

Examples

{{% redis-cli %}} SET mykey "10" DECRBY mykey 3 {{% /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="decrby-return-info" tab1="RESP2" tab2="RESP3" >}}

Integer reply: the value of the key after decrementing it.

-tab-sep-

Integer reply: the value of the key after decrementing it.

{{< /multitabs >}}