Go to file
2021-01-20 18:05:38 +08:00
.github Update github config files 2021-01-12 16:39:00 +08:00
data Wip 2021-01-11 17:55:24 +08:00
examples Add ffmt 2021-01-19 18:21:36 +08:00
.editorconfig Build the basic skeleton 2021-01-08 17:28:15 +08:00
.gitattributes Build the basic skeleton 2021-01-08 17:28:15 +08:00
.gitignore Add feature testing 2021-01-12 15:02:21 +08:00
CHANGELOG.md Build the basic skeleton 2021-01-08 17:28:15 +08:00
checker.go Fix fake method 2021-01-12 11:18:07 +08:00
feature_test.go Update github config files 2021-01-12 16:09:37 +08:00
generator.go Update go.mod 2021-01-12 11:36:44 +08:00
go.mod Add ffmt 2021-01-19 18:21:36 +08:00
go.sum Add ffmt 2021-01-19 18:21:36 +08:00
helper.go Update go.mod 2021-01-12 11:36:44 +08:00
id_validator.go Update README.md 2021-01-12 14:18:17 +08:00
LICENSE Build the basic skeleton 2021-01-08 17:28:15 +08:00
Makefile Update Makefile 2021-01-19 17:08:30 +08:00
README-ES.md Update README.md 2021-01-20 18:05:38 +08:00
README.md Update README.md 2021-01-20 18:05:38 +08:00

id-validator

简体中文 | ENGLISH

中国身份证号验证。

Tests gocover.io Go Report Card GoDoc GitHub release GitHub license

功能

  • 中国身份证号验证
  • 获取身份证号信息
  • 升级 15 位身份证号为 18 位
  • 伪造符合校验的身份证号

环境要求

  • Go >= 1.11

安装

$ go get -u github.com/guanguans/id-validator

使用

这只是一个快速介绍, 请查看 GoDoc 获得详细信息。

package main

import (
	idvalidator "github.com/guanguans/id-validator"
	"gopkg.in/ffmt.v1"
)

func main() {

	// 验证身份证号合法性
	ffmt.P(idvalidator.IsValid("440308199901101512"))  // 大陆居民身份证18位
	ffmt.P(idvalidator.IsValid("610104620927690"))     // 大陆居民身份证15位
	ffmt.P(idvalidator.IsValid("810000199408230021"))  // 港澳居民居住证18位
	ffmt.P(idvalidator.IsValid("830000199201300022"))  // 台湾居民居住证18位

	// 获取身份证号信息
	ffmt.P(idvalidator.GetInfo("440308199901101512"))
	// []interface {}[
	// 	github.com/guanguans/id-validator.IdInfo{          // 身份证号信息
	// 		AddressCode: int(440308)                           // 地址码
	// 		Abandoned:   int(0)                                // 地址码是否废弃1为废弃的0为正在使用的
	// 		Address:     string("广东省深圳市盐田区")             // 地址
	// 		AddressTree: []string[                             // 省市区三级列表
	//			string("广东省")                                    // 省
	//			string("深圳市")                                    // 市
	//			string("盐田区")                                    // 区
	//		]
	// 		Birthday:      <1999-01-10 00:00:00 +0000 UTC>     // 出生日期
	// 		Constellation: string("摩羯座")                     // 星座
	// 		ChineseZodiac: string("卯兔")                       // 生肖
	// 		Sex:           int(1)                              // 性别1为男性0为女性
	// 		Length:        int(18)                             // 号码长度
	// 		CheckBit:      string("2")                         // 校验码
	// 	}
	// 	<nil>                                              // 错误信息
	// ]

	// 生成可通过校验的假身份证号
	ffmt.P(idvalidator.FakeId()) // 随机生成
	ffmt.P(idvalidator.FakeRequireId(true, "江苏省", "200001", 1)) // 生成出生于2000年1月江苏省的男性居民身份证

	// 15位号码升级为18位
	ffmt.P(idvalidator.UpgradeId("610104620927690"))
	// []interface {}[
	// 	string("610104196209276908") // 升级后号码
	// 	<nil>                        // 错误信息
	// ]
}

测试

$ go test

变更日志

请参阅 CHANGELOG 获取最近有关更改的更多信息。

贡献指南

请参阅 CONTRIBUTING 有关详细信息。

安全漏洞

请查看我们的安全政策了解如何报告安全漏洞。

贡献者

相关项目

参考资料

协议

MIT 许可证MIT。有关更多信息请参见协议文件