currency.js是一款 js处理货币格式格式插件。currency.js提供非常灵活的api来帮助您解决javascript中的浮点数问题，并提供格式化货币数值功能，使用起来非常方便。

currency.js使用Es6语法编写，只有支持Es6语法的浏览器才能正常使用该插件。

使用方法

在页面中引入的currency.js文件。

<script src="js/currency.js"></script>
基本使用

currency.js可以接收数值，字符串或货币对象作为参数值。

currency(123);      // 123.00
currency(1.23);     // 1.23
currency("1.23")    // 1.23
currency("$12.30")  // 12.30

var value = currency("123.45");
currency(value);    // 123.45

currency.js提供一组数学运算方法来帮助您进行浮点数计算。

currency(123.50).add(0.23);       // 123.73
currency(5.00).subtract(0.50);    // 4.50
currency(45.25).multiply(3);      // 135.75
currency(1.12).distribute(5);     // [0.23, 0.23, 0.22, 0.22, 0.22]

currency.js内置了格式化功能，能正确的显示逗号和圆点分隔符。

currency("2,573,693.75").add("100,275.50").format();  // "2,673,969.25"
currency("1,237.72").subtract(300).format();          // "937.72"

你也可以自定义自己的货币数值格式。

var euro = value => currency(value, { separator: ".", decimal: "," });
euro("2.573.693,75").add("100.275,50").format();  // "2.673.969,25"
euro("1.237,72").subtract(300).format();          // "937,72"

配置参数

currency.js可用的配置参数有：

  • symbol：货币的符号，默认值为$。 
    currency(1.23, { formatWithSymbol: true }).format(); // => "$1.23"
  • symbol：是否在调用currency.format()方法时使用逗号分隔符，默认为,。 
    currency(1234.56, { symbol: ',' }).format(); // => "1,234.56"
currency(1234.56, { symbol: ' ' }).format(); // => "1 234.56"
  • decimal： 
    currency(1.23, { decimal: '.' }).format(); // => "1.23"
currency(1.23, { decimal: ',' }).format(); // => "1,23"
  • precision：保留小数点的位数。默认保留2位。 
    currency(1.234, { precision: 2 }); // => "1.23"
currency(1.234, { precision: 3 }); // => "1.234"
  • formatWithSymbol：是否在调用currency.format()方法时使用货币符号。默认值为false。 
    currency(1.23, { formatWithSymbol: true }).format(); // => "$1.23"
currency(1.23, { formatWithSymbol: false }).format(); // => "1.23"
  • errorOnInvalid：当传入null或undefined等不正确的值时，currency抛出异常。默认值为false。 
    currency(undefined, { errorOnInvalid: true }); // throws an error
  • increment：When implementing a currency that implements rounding, setting the increment value will allow you to set the closest increment to round the display value to. 
    var currencyRounding = value => currency(value, { increment: .05 });
currencyRounding(1.09); // => { intValue: 109, value: 1.09 }
currencyRounding(1.09).format(); // => "1.10"
currencyRounding(1.06); // => { intValue: 106, value: 1.06 }
currencyRounding(1.06).format(); // => "1.05"
  • useVedic：使用印度编号系统来显示货币数值。默认值是false。 
    currency(1234567.89, { useVedic: true }).format(); // => "12,34,567.89"

方法

currency.js可用的方法有：

  • currency.add( value )：加法运算。 
    currency(123.45).add(.01); // => "123.46"
  • currency.subtract( value )：减法运算。 
    currency(123.45).subtract(.01); // => "123.44"
  • currency.multiply( number )：乘法运算。 
    currency(123.45).multiply(2); // => "246.90"
  • currency.divide( number )：除法运算。 
    currency(123.45).divide(2); // => "61.73"
  • currency.distribute( number )：平均分配。 
    currency(12.35).distribute(3); // => [4.12, 4.12, 4.11]
currency(12.00).distribute(3); // => [4.00, 4.00, 4.00]
  • currency.format([ boolean ])：返回格式化后的货币格式。 
    currency(1000.00).format(); // => "1,000.00"
currency("1,234,567/90").add("200,000").format(); // => "1,434,567.89"

    上面是默认的格式，你可以通过下面的方法来自定义货币格式。

    var euro = value => currency(value, { separator: ' ', decimal: ',' });

// ...

euro(1000.00).format(); // => "1 000,00"
euro(1234567.89).add("200 000").format(); // => "1 434 567,89"

    结合symbol参数，可以显示出带符号的货币格式。

    var money = value => currency(value, { formatWithSymbol: true });

money(1000.00).format(); // => "$1,000.00"
money(1000.00).format(false); // => "1,000.00"
  • currency.dollars：返回货币的dollar值。 
    currency(123.45).dollars(); // => 123
currency("0.99").dollars(); // => 0
  • currency.cents：返回货币的cent值。 
    currency(123.45).cents(); // => 45
currency("0.99").cents(); // => 99
  • 国际化（i18n）和格式：currency.js默认使用的是美国货币，你可以使用下面的方法来将货币格式本地化。 
    const USD = value => currency(value);
const RMB = value => currency(value, { precision: 0, symbol: '¥' });
const EURO = value => currency(value, { symbol: '€', decimal: ',', separator: '.' });

USD(1234.567).format(true); // => "$1,234.57"
RMB(1234.567).format(true); // => "¥1,235"
EURO(1234.567).format(true); // => "€1.234,57"

currency.js js处理货币格式格式插件的github地址为：https://github.com/scurker/currency.js