> For the complete documentation index, see [llms.txt](https://money2.onepub.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://money2.onepub.dev/formatting.md).

# Formatting

The money class provides a simple way of formatting currency using a pattern.

When you create a Currency instance you can provide a default format pattern which is used to format a Money instance when you call `Money.toString()`.

The CommonCurrencies have default formatters for each Currency which is consistent with that currencies standards.

In some cases you may however want to format a Money instances in a specific manner. In this case you can use:

`Money.format(String pattern)`

```dart
import 'package:money2/money2.dart';
     test('formatting', () {
        final usd = Currency.create('USD', 2);
        final one = Money.fromIntWithCurrency(100, usd);
        expect(one.format('S0'), equals(r'$1'));
      });
```