Golang国际化标准数据处理插件库countries的使用

简介

countries是一个Golang库，提供ISO 639、ISO 3166(ISO3166-1, ISO3166, Digit, Alpha-2, Alpha-3)国家代码及其分区和名称(英文和俄文)、ISO4217货币代码、ITU-T E.164国际拨号代码、国家首都、UN M.49地区代码、IANA ccTLD国家域名、FIPS、IOC/NOC和FIFA代码等功能。

支持的标准

• ISO 639-1
• ISO 3166-1
• ISO 3166-2
• ISO 4217
• ICANN
• IANA ccTLD
• ITU-T E.164
• IOC
• NOC
• FIFA
• FIPS
• UN M.49
• Unicode CLDR
• Unicode Emoticons Flags
• Unicode Emoticons Currencies
• UN World Countries Capitals

安装

go get github.com/biter777/countries

使用示例

基本使用

package main

import (
	"fmt"
	"github.com/biter777/countries"
)

func main() {
	// 获取日本国家信息
	countryJapan := countries.Japan
	
	// 打印各种国家信息
	fmt.Printf("英文国家名: %v\n", countryJapan)                   // Japan
	fmt.Printf("俄文国家名: %v\n", countryJapan.StringRus())       // Япония
	fmt.Printf("ISO-3166数字代码: %d\n", countryJapan)            // 392
	fmt.Printf("ISO-3166 Alpha-2代码: %v\n", countryJapan.Alpha2()) // JP
	fmt.Printf("ISO-3166 Alpha-3代码: %v\n", countryJapan.Alpha3()) // JPN
	fmt.Printf("IOC/NOC代码: %v\n", countryJapan.IOC())           // JPN
	fmt.Printf("FIFA代码: %v\n", countryJapan.FIFA())             // JPN
	fmt.Printf("FIPS代码: %v\n", countryJapan.FIPS())             // JA
	fmt.Printf("首都: %v\n", countryJapan.Capital())              // Tokyo
	fmt.Printf("国际电话区号: %v\n", countryJapan.CallCodes())     // +81
	fmt.Printf("国家顶级域名: %v\n", countryJapan.Domain())        // .jp
	fmt.Printf("UN M.49地区名: %v\n", countryJapan.Region())     // Asia
	fmt.Printf("UN M.49地区代码: %d\n", countryJapan.Region())    // 142
	fmt.Printf("国旗emoji: %v\n", countryJapan.Emoji())          // 🇯🇵
	fmt.Printf("行政区划: %v\n", countryJapan.Subdivisions())      // Hokkaido Aomori Iwate...

	// 获取货币信息
	currencyJapan := countryJapan.Currency()
	fmt.Printf("货币英文名: %v\n", currencyJapan)                // Yen
	fmt.Printf("货币数字代码: %d\n", currencyJapan)               // 392
	fmt.Printf("货币Alpha代码: %v\n", currencyJapan.Alpha())     // JPY
	fmt.Printf("货币emoji: %v\n", currencyJapan.Emoji())       // 💴
	fmt.Printf("使用该货币的国家: %v\n", currencyJapan.Countries()) // Japan
}

使用Info结构体获取信息

// 使用Info结构体获取国家信息
japanInfo := countries.Japan.Info()
fmt.Printf("英文国家名: %v\n", japanInfo.Name)                     // Japan
fmt.Printf("ISO-3166数字代码: %d\n", japanInfo.Code)             // 392
fmt.Printf("ISO-3166 Alpha-2代码: %v\n", japanInfo.Alpha2)      // JP
fmt.Printf("ISO-3166 Alpha-3代码: %v\n", japanInfo.Alpha3)      // JPN
fmt.Printf("IOC/NOC代码: %v\n", japanInfo.IOC)                  // JPN
fmt.Printf("FIFA代码: %v\n", japanInfo.FIFA)                    // JPN
fmt.Printf("FIPS代码: %v\n", japanInfo.FIPS)                    // JA
fmt.Printf("首都: %v\n", japanInfo.Capital)                     // Tokyo
fmt.Printf("国际电话区号: %v\n", japanInfo.CallCodes)            // +81
fmt.Printf("国家顶级域名: %v\n", japanInfo.Domain)               // .jp
fmt.Printf("UN M.49地区名: %v\n", japanInfo.Region)             // Asia
fmt.Printf("UN M.49地区代码: %d\n", japanInfo.Region)           // 142
fmt.Printf("国旗emoji: %v\n", japanInfo.Emoji)                  // 🇯🇵
fmt.Printf("货币英文名: %v\n", japanInfo.Currency)               // Yen
fmt.Printf("货币数字代码: %d\n", japanInfo.Currency)             // 392
fmt.Printf("货币Alpha代码: %v\n", japanInfo.Currency.Alpha())   // JPY
fmt.Printf("行政区划: %v\n", japanInfo.Subdivisions)             // Hokkaido Aomori Iwate...

国家查找功能

// 通过国家名查找
country := countries.ByName("angola")
fmt.Printf("英文国家名: %v\n", country)                // Angola
fmt.Printf("ISO-3166数字代码: %d\n", country)        // 24
fmt.Printf("ISO-3166 Alpha-2代码: %v\n", country.Alpha2()) // AO
fmt.Printf("ISO-3166 Alpha-3代码: %v\n", country.Alpha3()) // AGO

// 通过国家代码查找
country = countries.ByName("AO")
fmt.Printf("英文国家名: %v\n", country.String())     // Angola
fmt.Printf("ISO-3166数字代码: %d\n", country)        // 24
fmt.Printf("ISO-3166 Alpha-2代码: %v\n", country.Alpha2()) // AO
fmt.Printf("ISO-3166 Alpha-3代码: %v\n", country.Alpha3()) // AGO

// 通过数字代码查找
country = countries.ByNumeric(24)
fmt.Printf("英文国家名: %v\n", country)                // Angola
fmt.Printf("ISO-3166数字代码: %d\n", country)        // 24
fmt.Printf("ISO-3166 Alpha-2代码: %v\n", country.Alpha2()) // AO
fmt.Printf("ISO-3166 Alpha-3代码: %v\n", country.Alpha3()) // AGO

比较功能

// 通过代码/数字比较
if countries.ByName("angola") == countries.AGO {
	fmt.Println("Yes! It's Angola!") // Yes! It's Angola!
}

// 通过名称比较
if strings.EqualFold("angola", countries.AGO.String()) {
	fmt.Println("Yes! It's Angola!") // Yes! It's Angola!
}

数据库使用示例

type User struct {
	gorm.Model
	Name     string
	Country  countries.CountryCode
	Currency countries.CurrencyCode
}

func main() {
	user := &User{Name: "Helen", Country: countries.Slovenia, Currency: countries.CurrencyEUR}
	db, err := gorm.Open("postgres", 500, "host=127.0.0.2 port=5432 user=usr password=1234567 dbname=db")
	if err != nil {
		panic(err)
	}
	defer db.Close()
	db.Create(user)
}

导入

import "github.com/biter777/countries"

这个库提供了丰富的国家、地区和货币信息处理功能，适用于需要国际化支持的Golang应用程序。