nwidart/money-formatter

A money formatting package.

MoneyFormatter

, _(*1)

A simple package used for formatting a Money\Money value object., _(*2)

Money is usually not stored as a float in your database, though your clients/users don't want to see 1000 meaning, 10. This package receives an amount in cents, and displays it according to the given locale with or with the currency symbol., _(*3)

Want to use this inside a Laravel application? Check out the MoneyFormatter-Laravel package., _(*4)

Install

Via Composer, _(*5)

``` bash $ composer require nwidart/money-formatter, <sub>(*6)</sub>

## Usage

To format money in **cents**:

``` php
$formatter = new MoneyFormatter('en_US');
$formattedMoney = $formatter->format(new Money(1000, new Currency('USD')));
# output : $10.00

Sometimes you may wish to not have the currency symbol, this can be done like so:, <sub>(*7)</sub>

``` php $formatter = new MoneyFormatter('en_US'); $formattedMoney = $formatter->formatWithoutCurrency(new Money(1000, new Currency('USD')));, <sub>(*8)</sub>

output : 10.00

This can be useful if your currency selection is a separate dropdown, for instance.

## Testing

``` bash
$ phpunit

Contributing

Please see CONTRIBUTING for details., <sub>(*9)</sub>

Credits

• Nicolas Widart
• Philip Brown for the inspiration from his Basket package. Decided to extract the MoneyFormatter class to a dedicated package.
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*10)</sub>