Golang Money 库使用指南

money 是一个用于处理货币金额和汇率计算的 Go 语言库，它提供了不可变金额类型和无恐慌算术操作，非常适合金融应用开发。

主要特性

• 不可变金额类型，确保线程安全
• 无恐慌算术操作，避免运行时错误
• 支持多币种和汇率计算
• 精确的十进制运算

安装

go get github.com/rhymond/go-money

基本用法

创建金额

package main

import (
	"fmt"
	"github.com/rhymond/go-money"
)

func main() {
	// 创建金额（默认货币为USD）
	amount := money.New(1000, "USD") // 表示10.00美元
	
	// 获取金额信息
	fmt.Println("Amount:", amount.Amount())    // 1000
	fmt.Println("Currency:", amount.Currency()) // USD
	fmt.Println("Display:", amount.Display())  // $10.00
}

算术运算

// 加法
five := money.New(500, "USD")
ten := money.New(1000, "USD")
fifteen, err := five.Add(ten)
if err != nil {
	fmt.Println("Error:", err)
} else {
	fmt.Println("Sum:", fifteen.Display()) // $15.00
}

// 减法
diff, err := ten.Subtract(five)
if err != nil {
	fmt.Println("Error:", err)
} else {
	fmt.Println("Difference:", diff.Display()) // $5.00
}

// 乘法
double, err := five.Multiply(2)
if err != nil {
	fmt.Println("Error:", err)
} else {
	fmt.Println("Double:", double.Display()) // $10.00
}

// 除法
half, err := five.Divide(2)
if err != nil {
	fmt.Println("Error:", err)
} else {
	fmt.Println("Half:", half.Display()) // $2.50
}

比较操作

a := money.New(1000, "USD")
b := money.New(1500, "USD")

// 大于
if a.GreaterThan(b) {
	fmt.Println("a is greater than b")
}

// 小于
if a.LessThan(b) {
	fmt.Println("a is less than b") // 会执行
}

// 等于
if a.Equals(money.New(1000, "USD")) {
	fmt.Println("a equals 10 USD") // 会执行
}

汇率计算

package main

import (
	"fmt"
	"github.com/rhymond/go-money"
)

func main() {
	// 创建汇率转换器
	rates := money.NewExchangeRates()
	
	// 添加汇率（1 USD = 0.85 EUR）
	err := rates.AddRate("USD", "EUR", 0.85)
	if err != nil {
		fmt.Println("Error adding rate:", err)
		return
	}
	
	// 转换金额
	usd := money.New(1000, "USD") // 10美元
	eur, err := rates.Convert(usd, "EUR")
	if err != nil {
		fmt.Println("Error converting:", err)
		return
	}
	
	fmt.Printf("%s = %s\n", usd.Display(), eur.Display()) // $10.00 = €8.50
	
	// 批量添加汇率
	rates.AddRates(map[string]map[string]float64{
		"USD": {
			"GBP": 0.75,
			"JPY": 110.0,
		},
	})
	
	// 转换为英镑
	gbp, err := rates.Convert(usd, "GBP")
	if err != nil {
		fmt.Println("Error converting:", err)
		return
	}
	fmt.Printf("%s = %s\n", usd.Display(), gbp.Display()) // $10.00 = £7.50
}

高级功能

分配金额

total := money.New(1000, "USD")
parts, err := total.Allocate(3, 7) // 按3:7比例分配
if err != nil {
	fmt.Println("Error allocating:", err)
} else {
	fmt.Println("Part 1:", parts[0].Display()) // $3.00
	fmt.Println("Part 2:", parts[1].Display()) // $7.00
}

格式化输出

amount := money.New(123456, "USD")

// 自定义格式化
fmt.Println(amount.Display())          // $1,234.56
fmt.Println(amount.DisplayNoSymbol())  // 1,234.56
fmt.Println(amount.DisplayNoComma())   // $1234.56
fmt.Println(amount.DisplayNoFraction()) // $1,234

最佳实践

1. 始终检查错误：虽然称为"无恐慌"，但操作仍可能返回错误（如货币不匹配）
2. 避免直接使用整数：使用库提供的构造函数和方法
3. 考虑性能：频繁创建新对象可能影响性能，必要时可复用对象
4. 处理货币精度：不同货币可能有不同的小数位数

money 库为 Go 开发者提供了安全、可靠的货币处理能力，特别适合需要精确金融计算的应用程序。