Math & Text
round
$round[]
The function $round[] rounds a number to the nearest integer according to standard rounding rules.
Syntax
bdfd
$round[value]
Syntax
$round[value]
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
value |
number | Yes | The number to round. |
Behavior
- If the decimal part is strictly less than .5: rounds down.
- If the decimal part is greater than or equal to .5: rounds up.
- For an integer: returns the integer itself.
Examples
Rounding to Nearest Integer
$title[Math: Round Function]
$description[Rounding `3.5`: **$round[3.5]**
Rounding `3.4`: **$round[3.4]**]
$addField[Negative Value;$round[-3.6];yes]
$addField[Exact Integer;$round[5];yes]
$color[#5865F2]
$sendMessage[]
Comparison: floor / ceil / round
| Value | $floor[] | $ceil[] | $round[] |
|---|---|---|---|
3.2 |
3 |
4 |
3 |
3.5 |
3 |
4 |
4 |
3.9 |
3 |
4 |
4 |
-3.2 |
-4 |
-3 |
-3 |
-3.5 |
-4 |
-3 |
-3* |
*The exact behavior for values ending in .5 may depend on the underlying Java implementation (Math.round).
Notes
- The result is always an integer (in the form of a string).
- Use
$floor[]to always round down, and$ceil[]to always round up. - For finer control (number of decimal places), use
$calculate[].