flutter_money_formatter 0.6.0

FlutterMoneyFormatter is a Flutter extension to formatting various types of currencies according to the characteristics you like, without having to be tied to any localization.

FlutterMoneyFormatter

FlutterMoneyFormatter is a Flutter extension to formatting various types of currencies according to the characteristics you like, without having to be tied to any localization.

Dependencies :

---

Install

For complete steps in installing FlutterMoneyFormatter you can see in the Installation Guide.

Usage

Import the library

import 'package:flutter_money_formatter/flutter_money_formatter.dart';

Getting Started

To be able to format your double value into the various formats you want, you first need to create a FlutterMoneyFormatter instance like the following:

FlutterMoneyFormatter fmf = FlutterMoneyFormatter(
    amount: 12345678.9012345
);

Note, the code above still uses the default configuration as explained here.

After that you can request various results of the format as follows:

// normal form
print(fmf.output.formattedNonSymbol); // 12,345,678.90
print(fmf.output.formattedLeftSymbol); // $ 12,345,678.90
print(fmf.output.formattedRightSymbol); // 12,345,678.90 $
print(fmf.output.fractionDigitsOnly); // 90
print(fmf.output.withoutDecimal); // 12,345,678

// compact form
print(fmf.output.compactNonSymbol) // 12.3M
print(fmf.output.compactLeftSymbol) // $ 12.3M
print(fmf.output.compactRightSymbol) // 12.3M $

If you will use the output format several times, I strongly recommend that you initialize a variable as in the following example:

MoneyFormatterOutput fo = fmf.output;

Or directly when initializing the FlutterMoneyFormatter instance as in the following example:

MoneyFormatterOutput fo = FlutterMoneyFormatter(
    amount: 12345678.9012345
).output;

So you can immediately take the value more easily as in the following example:

// normal form
print(fo.formattedNonSymbol); // 12,345,678.90
print(fo.formattedLeftSymbol); // $ 12,345,678.90
print(fo.formattedRightSymbol); // 12,345,678.90 $
print(fo.fractionDigitsOnly); // 90
print(fo.withoutDecimal); // 12,345,678

// compact form
print(fo.compactNonSymbol) // 12.3M
print(fo.compactLeftSymbol) // $ 12.3M
print(fo.compactRightSymbol) // 12.3M $

See demo section to get more info.

Configurations

To adjust the format to suit your needs, you can set it through the settings parameter:

FlutterMoneyFormatter fmf = new FlutterMoneyFormatter(
    amount: 12345678.9012345,
    settings: MoneyFormatterSettings(
        symbol: 'IDR',
        thousandSeparator: '.',
        decimalSeparator: ',',
        symbolAndNumberSeparator: ' ',
        fractionDigits: 3,
        compactFormatType: CompactFormatType.sort
    )
)

Of course you are not required to initialize the entire configuration in the settings (MoneyFormatterSettings) parameter as in the example above. You can change one or more of the configurations above. This is because each configuration above is not mandatory and has a default value.

---

Properties, Methods, and Functions

• FlutterMoneyFormatter

Property Names	Data Type	Descriptions
amount	double	Amount number that will be formatted.
settings	MoneyFormatterSettings	See here.
output	MoneyFormatterOutput	See here.
comparator	MoneyFormatterCompare	See here.
CopyWith	FlutterMoneyFormatter	see here

• MoneyFormatterSettings

Configuration Property	Data Type	Default Value	Description
symbol	String	$ (Dollar Sign)	The symbol that will be used on formatted output.
thousandSeparator	String	,	The character that will be used as thousand separator on formatted output.
decimalSeparator	String	.	The character that will be used as decimal separator on formatted output.
fractionDigits	int	2	The fraction digits that will be used on formatted output.
symbolAndNumberSeparator	String	' ' (Space)	The character that will be used as separator between formatted number and currency symbol.
compactFormatType	CompactFormatType	CompactFormatType.sort	See here.

• CompactFormatType

You can change the type of compact format like for million using M or million, or trillion using T or trillion. and so on. This type only supports two type as described below:

Value	Description
CompactFormatType.sort	Used to make the compact format displayed using sort text.
CompactFormatType.long	Used to make the compact format displayed using long text.

• MoneyFormatterOutput

You can use formats that match your needs through properties found in the MoneyFormatterOutput instance.

Property Names	Data Type	Descriptions
nonSymbol	String	The results of the format of the currency are normal and without a currency symbol. Example: 12,345,678.90
symbolOnLeft	String	The results of the normal currency format and with currency symbols are on the left. Example: $ 12,345,678.90
symbolOnRight	String	The results of the normal currency format and with currency symbols are on the right. Example: 12,345,678.90 $
compactNonSymbol	String	The results of the currency format are compact and without a currency symbol. Example: 12.3M
compactSymbolOnLeft	String	The results of the currency format are compact and with currency symbols on the left. example: $ 12.3M
compactSymbolOnRight	String	The results of the currency format are compact and with currency symbols on the right. example: 12.3M $
fractionDigitsOnly	String	Only give the fraction value. Example: 90
withoutFractionDigits	String	Give a value without fractions. Example: 12,345,678

• MoneyFormatterCompare

Method	Parameter	Descriptions
isLowerThan	amount	Check current instance-amount is lower than [amount] or not.
isGreaterThan	amount	Check current instance-amount is greater than [amount] or not.
isEqual	amount	Check current instance amount is equal than [amount] or not.
isEqualOrLowerThan	amount	Check current instance amount is equal or lower than [amount] or not.
isEqualOrGreaterThan	amount	Check current instance amount is equal or greater than [amount] or not.

Example of using a comparator:

FlutterMoneyFormatter fmf = FlutterMoneyFormatter(amount: 12345678.9012345);
double comparerValue = 5678.9012;

print(fmf.comparator.isEqual(5678.9012)); // false
print(fmf.comparator.isGreaterThan(5678.9012)); // true

---

Duplicating Instance

For some reasons, you may need to duplicate the instance and just need to change some configurations. To do that, you can use the copyWith method as below:

FlutterMoneyFormatter fmf = FlutterMoneyFormatter(amount: 12345678.9012345);

print(fmf.output.formattedLeftSymbol); // $ 12,345,678.90
print(fmf.copyWith(symbol: 'IDR', symbolAndNumberSeparator: '-').output.formattedLeftSymbol); // IDR-12,345,678.90

---

Demo

For more complete samples, you can grab it from the example directory.

Our Other Package

See our other packages here.

Help Me

If you find any issues, bugs, have questions, or want to request a new features you can do it here. You can also help me to improve features or fix some issues by forking this project via Github

ChangeLog

Are you curious about the changes that occur in each version? See here for detailed informations.