货币工具 - MoneyUtil

由来

货币计算中浮点精度问题会导致金额错误（如 0.1 + 0.2 != 0.3）。MoneyUtil 使用 Decimal 精确运算，提供元/分转换和含税/不含税价格计算。

方法

元/分转换

from hutool import MoneyUtil

MoneyUtil.fen_to_yuan(100)      # Decimal('1.00')
MoneyUtil.fen_to_yuan(1)        # Decimal('0.01')
MoneyUtil.fen_to_yuan('50')     # Decimal('0.50')

MoneyUtil.yuan_to_fen(1)        # 100
MoneyUtil.yuan_to_fen('0.5')    # 50
MoneyUtil.yuan_to_fen('0.01')   # 1

税价计算

默认增值税率为 13%（中国标准增值税率），可通过参数自定义：

from decimal import Decimal

# 不含税价 → 含税价
MoneyUtil.gross_price(Decimal('100'))            # Decimal('113.00')
MoneyUtil.gross_price(Decimal('100'), tax_rate=8)  # Decimal('108.00')

# 含税价 → 不含税价
MoneyUtil.net_price(Decimal('113'))              # Decimal('100.00')
MoneyUtil.net_price(Decimal('108'), tax_rate=8)  # Decimal('100.00')

# 计算税额
MoneyUtil.tax_amount(Decimal('113'))             # Decimal('13.00')

利润率计算

from decimal import Decimal

# netto — 不含税金额
MoneyUtil.netto(Decimal('100'), Decimal('0.13'))  # Decimal('88.50')

# brutto — 含税金额
MoneyUtil.brutto(Decimal('100'), Decimal('0.13'))  # Decimal('113.00')

# profitMargin — 利润率
MoneyUtil.profit_margin(Decimal('100'), Decimal('80'))  # Decimal('25.00')

元/分互转（增强）

# centToYuan / yuanToCent — 与 fen_to_yuan / yuan_to_fen 相同
MoneyUtil.cent_to_yuan(100)    # Decimal('1.00')
MoneyUtil.yuan_to_cent(1.00)   # 100

税额计算（增强）

# taxAmount — 精确税额计算
MoneyUtil.tax_amount(Decimal('100'), Decimal('0.13'))  # Decimal('13.00')

---

备注

更多方法请参阅 API 参考 文档。