# Currency
---
### Description
Displays the provided value as Currency

### Methods
* `static format([value] [,defaultSymbol] [,hideCommas], [,hideCents], [,round] ) : string`

### Properties
* `value - number, default null`
* `defaultSymbol - string, default '$'`
* `hideCommas - boolean, default false`
* `round - boolean, default false`
* `extends` [Text](/typography)

### Usage
```
import Currency from 'hixme-ui/lib/Currency'

const currency = Currency.format({ value: 10.23 })

<Currency large primary value={10.23} />
```
### Notes
* for numbers over 99,999 or -99,999 `round` will round to the *nearest thousand*
* for numbers less then 100,000 or -100,000 `round` will round to the *nearest unit and remove cents*