go-finance 库使用指南：汇率查询、增值税号验证和IBAN校验

go-finance 是一个实用的金融工具库，提供了汇率查询、VIES增值税号验证和IBAN账号校验等功能。下面我将详细介绍如何使用这个库。

安装

首先安装 go-finance 库：

go get github.com/pioz/go-finance

1. 汇率查询

go-finance 提供了汇率查询功能，支持多种货币间的汇率转换。

package main

import (
	"fmt"
	"github.com/pioz/go-finance"
	"time"
)

func main() {
	// 获取最新汇率
	rate, err := finance.ExchangeRate("USD", "EUR")
	if err != nil {
		fmt.Println("获取汇率失败:", err)
		return
	}
	fmt.Printf("当前美元兑欧元汇率: 1 USD = %.4f EUR\n", rate)

	// 获取历史汇率
	date := time.Date(2023, 1, 1, 0, 0, 0, 0, time.UTC)
	historicalRate, err := finance.HistoricalExchangeRate("USD", "EUR", date)
	if err != nil {
		fmt.Println("获取历史汇率失败:", err)
		return
	}
	fmt.Printf("2023年1月1日美元兑欧元汇率: 1 USD = %.4f EUR\n", historicalRate)
}

2. VIES 增值税号验证

VIES (VAT Information Exchange System) 是欧盟的增值税号验证系统。

package main

import (
	"fmt"
	"github.com/pioz/go-finance"
)

func main() {
	// 验证欧盟增值税号
	// 参数：国家代码(2字母)，增值税号
	valid, name, address, err := finance.ViesCheckVAT("IT", "12345678901")
	if err != nil {
		fmt.Println("验证增值税号失败:", err)
		return
	}
	
	if valid {
		fmt.Println("增值税号有效")
		fmt.Println("公司名称:", name)
		fmt.Println("公司地址:", address)
	} else {
		fmt.Println("增值税号无效")
	}
}

3. IBAN 账号校验

IBAN (International Bank Account Number) 是国际银行账号标准。

package main

import (
	"fmt"
	"github.com/pioz/go-finance"
)

func main() {
	// 验证IBAN账号
	// 示例IBAN: 德国 DE89370400440532013000
	valid, err := finance.IbanCheck("DE89370400440532013000")
	if err != nil {
		fmt.Println("验证IBAN失败:", err)
		return
	}
	
	if valid {
		fmt.Println("IBAN账号有效")
	} else {
		fmt.Println("IBAN账号无效")
	}
	
	// 获取IBAN信息
	country, checkDigits, bban, err := finance.IbanSplit("DE89370400440532013000")
	if err != nil {
		fmt.Println("解析IBAN失败:", err)
		return
	}
	fmt.Println("国家代码:", country)
	fmt.Println("校验位:", checkDigits)
	fmt.Println("基本银行账号(BBAN):", bban)
}

高级用法

自定义HTTP客户端

package main

import (
	"fmt"
	"github.com/pioz/go-finance"
	"net/http"
	"time"
)

func main() {
	// 创建自定义HTTP客户端
	client := &http.Client{
		Timeout: 10 * time.Second,
	}
	
	// 设置自定义客户端
	finance.SetHTTPClient(client)
	
	// 现在所有请求都将使用这个自定义客户端
	rate, err := finance.ExchangeRate("USD", "JPY")
	if err != nil {
		fmt.Println("获取汇率失败:", err)
		return
	}
	fmt.Printf("当前美元兑日元汇率: 1 USD = %.2f JPY\n", rate)
}

批量验证IBAN

package main

import (
	"fmt"
	"github.com/pioz/go-finance"
)

func main() {
	ibans := []string{
		"DE89370400440532013000", // 有效
		"GB29NWBK60161331926819", // 有效
		"INVALIDIBAN123",         // 无效
	}
	
	for _, iban := range ibans {
		valid, err := finance.IbanCheck(iban)
		if err != nil {
			fmt.Printf("IBAN %s 验证错误: %v\n", iban, err)
			continue
		}
		
		if valid {
			fmt.Printf("IBAN %s 有效\n", iban)
		} else {
			fmt.Printf("IBAN %s 无效\n", iban)
		}
	}
}

注意事项

1. 汇率数据：汇率数据来源于公开API，可能有延迟或限制
2. VIES验证：欧盟增值税号验证需要联网，且欧盟服务器有时不稳定
3. IBAN校验：只验证格式有效性，不验证账号是否存在
4. 错误处理：所有函数都可能返回错误，应妥善处理

go-finance 是一个轻量级的库，适合需要快速集成金融相关功能的Go应用程序。对于生产环境，建议添加适当的缓存和错误重试机制。