The js class that handles the amount of money

Single currency currency type, handle currency arithmetic, currency and get integers.

Currently, the currency implements the following main functions:

• 1.Currency unit conversion;
• 2.Use the "Banker's Rounding Method";
• 3.Support direct object and object operation;
• 4.Support automatic acquisition of currency symbols;
• 5.Support size comparison and sorting between currency objects;
• 6.Support Nodejs and browser use at the same time.

Installing

If you use npm, npm install money-module. You can also download the latest release on GitHub.

NPM

npm i money-module --save

Instructions

const Money = require('money-module');
const money = new Money({
  cent: 1235357
});
const money1 = new Money('32563.286');
const money2 = new Money(23423.985);
const money3 = new Money({
  amount: 23523.87324244,
  centFactor: 1000
});


console.log('\nmoney: ', money.valueOf());
/**
 * money:  {
  amount: 12353.57,
  cent: 1235357,
  centFactor: 100,
  currency: 'CNY',
  md5: null,
  rsa: null
}
 */
console.log('TranslateNumber: ', money.getTranslateNumber());
//  12,353.57
console.log('showMoney: ', money.showMoney());
//  ¥12,353.57

//  Convert to U.S. dollars
money3.currency = 'USD';
console.log('4money: ', money3.valueOf());
/**
 * 4money:  {
  amount: 23523.873,
  cent: 23523873,
  centFactor: 1000,
  currency: 'USD',
  md5: null,
  rsa: null
}
 */
console.log('TranslateNumber: ', money3.getTranslateNumber());
//  23,523.87
console.log('showMoney: ', money3.showMoney());
//  $23,523.87


const moneys = [money, money1, money2, money3];
//  Calculation
const sum = Money.computed(`$ + ($ + $ + $) / $`, [...moneys, 2]);
console.log('sum: ', sum.valueOf())
/**
 * sum:  {
  amount: 52109.141,
  cent: 52109141,
  centFactor: 1000,
  currency: 'CNY',
  md5: null,
  rsa: null
}
 */


const datas = [...moneys, '3'];
//  Sort ascending
const sorts = Money.sort(datas);
console.log('sorts: ', sorts.map(e => e.amount || e - 0));
//  [ 3, 12353.57, 23423.98, 23523.873, 32563.29 ]
//  Sort descending
const sorts2 = Money.sort(datas, (a, b) => b - a);
console.log('sorts: ', sorts2.map(e => e.amount || e - 0));
//  [ 32563.29, 23523.873, 23423.98, 12353.57, 3 ]

Static object

| Name | default | Description | | --------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------ | | Money.symbol | { USD: '$',... } | Currency mapping | | Money.centFactors | [1, 10, 100, 1000] | Amount and cent conversion rate mapping. | | Money.computed | Money.computed(`$ + ($ + $ + $) / $`, [...moneys, 2]); | Amount calculation | | Money.sort | Money.sort([...moneys, 2]);Money.sort([...moneys, 2], (a, b) => b - a);| Sort by amount. |

Methods

| Name | default | Description | | --------------------- | ------------------------------------------------------------ | ------------------------------------------------------- | | currency | 'USD' | 'CNY' 'USD' | | amount | 0 | 1 / 1.02 | | cent | 0 | Cents | | centFactor | 100 | Amount and Cent conversion ratio. |

API

| Name | params | Description | | --------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | valueOf | money.valueOf(); | Convert to ordinary Object object. | | toString | money.toString(null, 2);money.toString(); | Serialization -> JSON.stringify() | | equals | money.equals(money2);// true/false | Determine whether two money objects are completely equal (judging by serialization) | | instanceof | money.instanceof(money2);// true/false | Determine whether the same amount type. | | isCurrency | money.isCurrency('USD');// true | Is it a valid currency type | | setMoney | money.setMoney(money) | Assign a value to a money object, which can be a number, a string, or a money object | | equals | money.equals(money2);// true/false | Determine whether two money objects are completely equal (judging by serialization) | | bankersAlgorithm | money.bankersAlgorithm(0.28 * 100, 2); | Banker's round,bankersAlgorithm(number, size). | | compareTo | money.bankersAlgorithm(money1);// money>money1 -> 1 | Greater than: 1, equal to: 0, less than: -1. | | greaterThan | money.greaterThan(money1);// money>money1 -> true | Determine whether this currency object is larger than another currency object. true/false| | getTranslateNumber | money.getTranslateNumber();// 23,523.87 | Thousand sign handling | | showMoney | money.showMoney();// $23,523.87 | Thousand character string with currency symbol . |