---
title: "formatNumber"
canonical: "https://support.appfire.com/space/PSJ/15488775/formatNumber"
format: markdown
---
> Macro (aura-html)


|  |  |  |  |
| --- | --- | --- | --- |
| **Syntax** | formatNumber(number, format) | **Package** |  |
| **Alias** |  | **Pkg Usage** |  |

## Description

> Macro (excerpt)
> 
> Formats a number according to a format string.

Formats a number according to a format string.

## Parameters

| Parameter name | Type | Required | Description |
| --- | --- | --- | --- |
| number | Number | Yes | Number to be formatted. |
| format | String | Yes | String that specifies the format. |

## Return Type

**String**

## Example

```
string a = formatNumber(123456.789 ,"###,###.###");
//The pound sign (#) denotes a digit, the comma is a placeholder for the grouping separator, and the period is a placeholder for the decimal separator.
print("a= " + a);

string b = formatNumber(12345.67, "$###,###.###");
print("b= " + b);

string c = formatNumber(123.78, "000000.000");
//The format specifies leading and trailing zeros, because the 0 character is used instead of the pound sign (#).
print("c= " + c);

string d = formatNumber(123456.789, "###.##");
// The number has three digits to the right of the decimal point, but the format has only two. The format method handles this by rounding up.
print("d=" + d);
```

Prints:  

          a= 123,456.789

          b = $12,345.67

          c= 000123.780

          d=123456.79

> ⚠️ The symbols are described in the following table: 
> ⚠️ 
> ⚠️ > Macro (legacy-content)

## See also

> Macro (contentbylabel)