> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# formatUnits

```ts theme={null}
function formatUnits(value, unit?): string
```

Converts `value` into a decimal string, assuming `unit` decimal places. The `unit` may be the number of decimal
places or the name of a unit (e.g. `"gwei"` for 9 decimal places).

## Parameters

| Parameter | Type                                                       | Description                             |
| :-------- | :--------------------------------------------------------- | :-------------------------------------- |
| `value`   | [`BigNumberish`](/sdk/content/type-aliases/BigNumberish)   | The value to convert.                   |
| `unit`?   | `string` \| [`Numeric`](/sdk/content/type-aliases/Numeric) | The unit to convert to. Default is `18` |

## Returns

`string`

The converted value.

## Throws

If the unit is invalid.

## Source

[utils/units.ts:33](https://github.com/dominant-strategies/quais.js/blob/c1c12d43f9d34c6baad2b0542bd6d0acd6fefcbf/src/utils/units.ts#L33)