Golang货币金额格式化处理插件库accounting的使用

accounting是一个用于货币和金额格式化的Golang库，灵感来源于accounting.js。

快速开始

安装库：

go get github.com/leekchan/accounting

基本使用示例

package main

import (
    "fmt"
    "math/big"

    "github.com/shopspring/decimal"
    "github.com/leekchan/accounting"
)

func main() {
    // 基本格式化示例
    ac := accounting.Accounting{Symbol: "$", Precision: 2}
    fmt.Println(ac.FormatMoney(123456789.213123))                       // "$123,456,789.21"
    fmt.Println(ac.FormatMoney(12345678))                               // "$12,345,678.00"
    fmt.Println(ac.FormatMoney(big.NewRat(77777777, 3)))                // "$25,925,925.67"
    fmt.Println(ac.FormatMoney(big.NewRat(-77777777, 3)))               // "-$25,925,925.67"
    fmt.Println(ac.FormatMoneyBigFloat(big.NewFloat(123456789.213123))) // "$123,456,789.21"
    fmt.Println(ac.FormatMoneyDecimal(decimal.New(123456789.213123, 0))) // "$123,456,789.21"

    // 欧洲格式
    ac = accounting.Accounting{Symbol: "€", Precision: 2, Thousand: ".", Decimal: ","}
    fmt.Println(ac.FormatMoney(4999.99))  // "€4.999,99"

    // 从Locale结构获取货币信息
    lc := LocaleInfo["USD"]
    ac = accounting.Accounting{Symbol: lc.ComSymbol, Precision: 2, Thousand: lc.ThouSep, Decimal: lc.DecSep}
    fmt.Println(ac.FormatMoney(500000)) // "$500,000.00"

    // 英镑格式，无小数
    ac = accounting.Accounting{Symbol: "£ ", Precision: 0}
    fmt.Println(ac.FormatMoney(500000)) // "£ 500,000"

    // 自定义格式化
    ac = accounting.Accounting{Symbol: "GBP", Precision: 0,
        Format: "%s %v", FormatNegative: "%s (%v)", FormatZero: "%s --"}
    fmt.Println(ac.FormatMoney(1000000)) // "GBP 1,000,000"
    fmt.Println(ac.FormatMoney(-5000))   // "GBP (5,000)"
    fmt.Println(ac.FormatMoney(0))       // "GBP --"
}

Accounting结构

type Accounting struct {
    Symbol         string // 货币符号(必需)
    Precision      int    // 小数位数(可选/默认:0)
    Thousand       string // 千位分隔符(可选/默认:,)
    Decimal        string // 小数分隔符(可选/默认:.)
    Format         string // 简单格式字符串(%v=值,%s=符号)(默认:%s%v)
    FormatNegative string // 负值格式字符串
    FormatZero     string // 零值格式字符串
}

格式化方法

1. FormatMoney(value interface{}) string - 支持多种类型的值
2. *FormatMoneyBigFloat(value big.Float) string - 仅支持big.Float
3. FormatMoneyInt(value int) string - 仅支持int
4. *FormatMoneyBigRat(value big.Rat) string - 仅支持big.Rat
5. FormatMoneyFloat64(value float64) string - 仅支持float64

数字格式化方法

1. FormatNumber(value interface{}, precision int, thousand string, decimal string) string
2. *FormatNumberBigFloat(value big.Float, precision int, thousand string, decimal string) string
3. FormatNumberInt(value int, precision int, thousand string, decimal string) string
4. *FormatNumberBigRat(value big.Rat, precision int, thousand string, decimal string) string
5. FormatNumberFloat64(value float64, precision int, thousand string, decimal string) string

反向格式化

fmt.Println(accounting.UnformatNumber("$45,000.50", 2, "USD")) // "45000.50"
fmt.Println(accounting.UnformatNumber("EUR 12.500,3474", 3, "EUR")) // "12500.347"

注意事项

请不要使用float64来计算货币金额。在进行操作时，浮点数可能会有误差。建议使用big.Rat(Go < 1.5)或big.Float(Go >= 1.5)。