---
title: formatNumber()
slug: formatnumber
docTags: 
createdAt: 2021-09-14T17:46:34.000Z
---

Converts a given value of type `Number` into a `String`.

### Syntax

`formatNumber(number[, format][, locale])`

-  `number` - the Number value to be converted to a String.
- `format` - 
- `locale` - 
- **Return type:** [String](docId\:Ujw2AQAktel5uukLuP73S) 

### Sample usage

`formatNumber(20)` returns `20` as a `String`.

### Supported data types

| **Input type**                             | **Return type**                         | **Logic**                                                          |
| ------------------------------------------ | --------------------------------------- | ------------------------------------------------------------------ |
| ****[Number](docId\:ucI5tCTfVBhonEJ6ZQijg) | [String](docId\:Ujw2AQAktel5uukLuP73S)  | If a Number value is passed, it's value will returned as a String. |
| *Unsupported data types*                   | **[Null](docId\:N9trVqonnBknqL9DrNBP6)  | Unsupported data types return `Null`.                              |