玩酷网

Dinero.js - 免费开源的 JS 货币处理工具库,完美解决浮点数精度问题

今天介绍一个在前后端处理货币的工具库,logo 很可爱,是一只蓝色的招财小猫。本文封面图底图来自免费 AI 图库 Sto

今天介绍一个在前后端处理货币的工具库,logo 很可爱,是一只蓝色的招财小猫。

本文封面图底图来自免费 AI 图库 StockCake。

Dinero.js 简介

Dinero.js 是一个用于货币计算的 JavaScript 工具库,解决开发者在金融、电商、会计等场景中处理货币时的精度丢失、汇率转换、格式化输出等痛点。和 JS 基本的 Number 类型或简单四则运算不同,Dinero.js 将货币抽象为不可变对象,通过封装金额、币种、精度等元数据,提供了一套类型安全、可链式调用的 API。

Dinero.js 官网

技术特性计算精准:基于整数运算原理(如将 10.99 元存储为 1099 分),避免 JS 浮点数精度导致意想不到的问题;多币种支持:支持全球 170+ 种货币的 ISO 标准代码,还可以扩展自定义币种;函数式编程:所有方法都会返回新实例,避免相互污染的副作用,非常适合复杂计算场景。开发上手体验

历史原因,JS 小数的精度是令人十分头大的 BUG,很容易出现意想不到的情况,特别是处理交易金额。

之前我在开发小程序商城时,我也曾经想过不少办法来解决,比如金额统一用分来存,避免产生小数来计算,不过因为开发时间有限,以及有太多因素要考虑,为了保证涉及金额业务的安全稳健,我最终还是选择了用 Dinero.js 这款货币处理库。

下面用演示一下具体用法。

安装和集成

npm 或 yarn:

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 还支持下面几个常见的金融业务场景:

分期计算:支持等额本息/等额本金算法优惠券分摊计算(如满减、折扣叠加)订单金额拆分(支付网关手续费计算)总结

更多的用法可以浏览官网的 API 文档,有更多的货币处理支持,这样我们不用考虑实现具体的计算逻辑细节,节省不少开发时间。

API 文档和代码例子

对了,Dinero.js 不仅能在前端使用,Node.js 也同样支持,毕竟前端主要用于展示,更核心的业务逻辑依赖后端,通过 Dinero.js 可以构建高可靠的货币处理系统。

免费开源说明

Dinero.js 是一个免费开源的 JS 工具库,源码采用 MIT 开源协议托管在 Github 上,我们可以自由下载来使用,用在商业项目上也完全没问题。

↓↓点击查看本次分享的网站。