Golang 货币金额处理与格式化：currency 库使用指南

在 Go 语言中处理货币金额时，使用专门的库可以避免浮点数精度问题并提供更好的格式化功能。currency 是一个优秀的 Go 库，专门用于货币金额的处理和格式化。

安装 currency 库

go get -u github.com/bojanz/currency

基本使用

1. 创建金额对象

package main

import (
	"fmt"
	"github.com/bojanz/currency"
)

func main() {
	// 从字符串创建金额
	amount, err := currency.NewAmount("1234.56", "USD")
	if err != nil {
		panic(err)
	}

	// 从整数创建金额 (以分为单位)
	amount2 := currency.NewAmountFromInt64(123456, "USD", 2) // 1234.56 USD

	fmt.Println(amount.String())  // 输出: 1234.56 USD
	fmt.Println(amount2.String()) // 输出: 1234.56 USD
}

2. 金额运算

func main() {
	a, _ := currency.NewAmount("100.50", "USD")
	b, _ := currency.NewAmount("50.25", "USD")

	// 加法
	sum, err := a.Add(b)
	if err != nil {
		panic(err)
	}
	fmt.Println("Sum:", sum) // 输出: Sum: 150.75 USD

	// 减法
	diff, err := a.Sub(b)
	if err != nil {
		panic(err)
	}
	fmt.Println("Difference:", diff) // 输出: Difference: 50.25 USD

	// 乘法 (乘以标量)
	product, err := a.Mul(2)
	if err != nil {
		panic(err)
	}
	fmt.Println("Product:", product) // 输出: Product: 201.00 USD

	// 除法 (除以标量)
	quotient, err := a.Div(2)
	if err != nil {
		panic(err)
	}
	fmt.Println("Quotient:", quotient) // 输出: Quotient: 50.25 USD
}

3. 金额比较

func main() {
	a, _ := currency.NewAmount("100.00", "USD")
	b, _ := currency.NewAmount("50.00", "USD")
	c, _ := currency.NewAmount("100.00", "USD")

	fmt.Println(a.Equal(b)) // false
	fmt.Println(a.Equal(c)) // true
	fmt.Println(a.GreaterThan(b)) // true
	fmt.Println(a.LessThan(b)) // false
}

高级功能

1. 格式化金额

func main() {
	amount, _ := currency.NewAmount("1234.56", "USD")
	
	// 创建格式化器
	formatter := currency.NewFormatter(amount)
	
	// 设置格式选项
	formatter.NoGrouping(false) // 使用千位分隔符
	formatter.SetSymbol(currency.SymbolShow) // 显示货币符号
	
	// 格式化输出
	fmt.Println(formatter.Format()) // 输出: $1,234.56
	
	// 不同地区的格式化
	locale := currency.NewLocale("de-DE")
	eurAmount, _ := currency.NewAmount("1234.56", "EUR")
	deFormatter := currency.NewFormatter(eurAmount, locale)
	fmt.Println(deFormatter.Format()) // 输出: 1.234,56 €
}

2. 货币转换

func main() {
	// 创建汇率提供者
	rates := currency.NewRates()
	
	// 添加汇率 (1 USD = 0.85 EUR)
	rates.SetRate("USD", "EUR", 0.85)
	
	// 转换金额
	usdAmount, _ := currency.NewAmount("100.00", "USD")
	eurAmount, err := rates.Convert(usdAmount, "EUR")
	if err != nil {
		panic(err)
	}
	
	fmt.Println(eurAmount) // 输出: 85.00 EUR
}

3. 处理不同货币

func main() {
	usd, _ := currency.NewAmount("100.00", "USD")
	eur, _ := currency.NewAmount("85.00", "EUR")
	
	// 检查货币是否相同
	if usd.CurrencyCode() == eur.CurrencyCode() {
		fmt.Println("Same currency")
	} else {
		fmt.Println("Different currencies") // 输出: Different currencies
	}
	
	// 转换为相同货币再比较
	rates := currency.NewRates()
	rates.SetRate("USD", "EUR", 0.85)
	
	eurConverted, _ := rates.Convert(usd, "EUR")
	if eurConverted.Equal(eur) {
		fmt.Println("Amounts are equal after conversion") // 输出: Amounts are equal after conversion
	}
}

最佳实践

1. 始终使用 currency 库处理货币金额，避免使用 float64 或 float32，以防止精度问题。

2. 尽早验证货币代码：

   if !currency.IsValid("USDD") { // 注意: 错误的货币代码
       fmt.Println("Invalid currency code")
   }
   

3. 处理运算错误：

   result, err := amount1.Add(amount2)
   if err != nil {
       // 可能是货币不匹配或其他错误
       return fmt.Errorf("failed to add amounts: %w", err)
   }
   

4. 考虑使用上下文保存格式化选项：

   func formatForUser(amount currency.Amount, locale string) string {
       loc := currency.NewLocale(locale)
       formatter := currency.NewFormatter(amount, loc)
       formatter.NoGrouping(false)
       return formatter.Format()
   }
   

currency 库提供了强大而灵活的货币处理功能，适合电子商务、金融应用等需要精确货币计算的场景。通过合理使用这个库，可以避免常见的货币处理陷阱，并确保应用程序在全球范围内正确显示和处理货币金额。