# Number Operations

The **Number Operations** building block allows you to perform various mathematical and formatting operations on numbers. If the value to apply the operation on is empty, the TaskBot will take no action and continue its run.

***

### **Add**

Combine two numbers or concatenate two strings.

* **Examples** 
  * 1 + 1 ⟶ 2
  * "hello" + " world" ⟶ "hello world"
* **Use** **Case Example**
  * Add a counter to limit number of actions per TaskBot run. See example set-up: [Using Variables](/using-zerowork/using-variables.md#example-use-variable-to-limit-number-of-dms-sent-per-run)

### **Subtract**

Subtract one number from another.

* **Example**: 5 - 3 ⟶ 2

### **Multiply**

Multiply two numbers.

* **Example**: `4 * 3` ⟶ `12`
* See a use case example here: [Example: Standardize different formats](/using-zerowork/using-building-blocks/number-operations/example-standardize-different-formats.md)

### **Divide**

Divide one number by another.

* **Example**: 10 / 2 ⟶ 5

### **Remainder %**

Return the remainder after dividing one number by another.

* Example: 13 % 5 ⟶ 3

### **Round**

Round a number to the nearest whole number.

* **Example**: 2.6 ⟶ 3

### **Round up**

Round a number up to the nearest whole number.

* **Example**: 2.2 ⟶ 3

### **Round down**

Round a number down to the nearest whole number.

* **Example**: 2.7 ⟶ 2

### **Get random number**

Generate a random number within a specified range.

If no minimum or maximum values are provided, the TaskBot will use the default values: 0 for the minimum and 1,000,000,000 for the maximum.

* **Example**: Minimum 1, maximum 5 ⟶ 3.45

### **Set decimals**

Set the number of decimal places for a number.

* **Example**: 2 decimals: 5 ⟶ 5.00, 5.5333 ⟶ 5.53

### **Remove formatting**

Remove formatting such as commas or dots in a number.

If a number is used for arithmetic calculations (+, -, /, \*) or numeric comparisons (> or <), it is recommended to first convert it to a clean number for higher reliability. This is when this operation comes in handy.

* **Examples**
  * 1.000.000,23 is dot-grouped and will be converted to 1000000.23
  * 1,000,000.23 is comma-grouped and will be converted to 1000000.23
  * 1,000.000.23 has wrong format and an error report will be generated

***

**Additional Notes**

* If the value to perform the operation on (e.g., value to add to, number to round up) is not provided, the operation is skipped, and the TaskBot will continue without making changes.
* For operations requiring two values (e.g., add, subtract), if the value to use is not provided, the operation is skipped, and the TaskBot will continue without making changes.
* If the operation requires a valid number (any operation except *Add*) and the input is not a number, the TaskBot will generate an error report and stop the run.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zerowork.io/using-zerowork/using-building-blocks/number-operations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.