一款专门用于在JavaScript和TypeScript的货币处理工具库——Dinero.js

Dinero.js是一款专注于货币计算的JavaScript工具库，能够有效解决开发者在金融、电商、会计等场景中处理货币时常见的痛点，如精度丢失、汇率转换以及格式化输出等问题。与JavaScript基础的Number类型或简单的四则运算不同，Dinero.js将货币抽象为不可变对象，并封装了金额、币种、精度等元数据，从而提供了一套类型安全且支持链式调用的API。

Dinero.js功能特点：

1、安全性和可靠性：

-使用整数来表示货币金额，避免了JavaScript原生浮点数类型在处理货币时可能出现的精度问题。

-提供了不可变性设计，所有操作都不会改变原有的货币对象，而是返回一个新的对象，这有助于维护数据的完整性。

2、强大的货币操作功能：

– 创建货币对象：允许开发者以安全的方式创建表示货币的对象，金额以货币的最小单位（如美元的分）表示。

– 计算和比较：支持对货币对象进行加、减、乘、除等计算，以及比较两个货币对象的大小。

– 格式化：能够将货币对象格式化为不同地区的货币表示形式，包括货币符号、小数点格式等，还支持自定义格式化模板。

– 货币转换：支持在不同货币之间进行转换，考虑到汇率等因素。

– 分配功能：可以按照指定比例分配金额，同时尽可能均匀地分配余数。

3、良好的兼容性和扩展性：

– 主要使用TypeScript编写，同时支持JavaScript，既保证了类型的安全性，又提供了广泛的兼容性。

– 支持全局设置，允许开发者配置默认的货币单位、小数精度和区域设置。

– 提供了丰富的API，包括访问、操作、测试、转换和格式化货币对象的方法。

4、国际化支持：

– 内置对国际化的支持，无需额外的区域设置文件，可以直接使用`Intl`API进行货币格式化。

– 支持多种语言和地区的货币格式，开发者可以通过设置区域代码来调整输出格式。

5、易用性：

– 提供了链式调用的API，开发者可以方便地组合多个操作。

– 提供了详细的文档和示例，帮助开发者快速上手。

Dinero.js开发上手体验：

安装：

npm install dinero.js
  # 或
yarn add dinero.js

CDN引入：

<script src="https://unpkg.com/dinero.js@latest/dist/dinero.min.js"></script>

代码基础运算

import Dinero from 'dinero.js';

// 通过金额和币种创建一个货币实例
const price = Dinero({ amount: 1000, currency: 'USD' }); // 1000 美分
const tax = price.percentage(7); // 计算7%税费
const total = price.add(tax); // 相加总金额 1070 美分（即10.70美元）
// 在前端界面输出货币字符
console.log(total.toFormat()); // $10.70

// 便捷的链式调用
const discount = Dinero({ amount: 2000, currency: 'USD' })
  .multiply(3)
  .subtractPercentage(15)
  .divide(2);

多币种汇率转换

Dinero.globalExchangeRatesApi = {
  base: 'USD',
  rates: { EUR: 0.85, JPY: 110 }
}; // 设置汇率

const dollars = Dinero({ amount: 1000, currency: 'USD' });
const euros = dollars.convert('EUR'); // 转换为欧元 8.50€

进入Dinero.js官网入口