/idInfo

一个简单的提取 :cn: 身份证号码内含信息的工具

Primary LanguageJavaScriptMIT LicenseMIT

一个简单的提取 🇨🇳 身份证号码内含信息的工具

根据身份证号码提取该号码所在省(直辖市)、市、县(区)、生日、年龄以及进行合法性校验。

🔥 省、市、区信息来自民政部官网发布数据,优先匹配能匹配成功的最新数据。举两个例子:

🌰 330481 原为海宁县,现已变更为海宁市,行政区划代码未调整。则查询 330481 的结果为海宁市。

🌰 330107 原为半山区,现该区已并入拱墅区,行政区划代码已撤销。则查询 330107 的结果为半山区。

🍜 使用方法

from  idInfo import idInfo
idInfo(idNumber,basePath)
@params idNumber str: 身份证号码
@params basePath可选str: 地区代码文件共有地址
        默认为'idinfo/regionalismCode/regionalismCode_'

🙅 不要改动行政区划代码信息文件名中的数字。需要将此数字作为文件名结尾 ( 如 regionlismCode_2019 中的 2019),

😄 获取区域信息

👉 获取省(直辖市、特别行政区)名称

.getProvince()

返回对应省的中文名称 str。未匹配成功返回 unmatched

eg:

idInfo('35################').getProvince()
# 福建省

👉 获取市名称

.getCity()

返回对应市的中文名称 str。未匹配成功返回 unmatched

eg:

idInfo('3501##############').getCity()
# 福州市

👉 获取区(县)名称

.getCounty()

返回对应市的中文名称 str。未匹配成功返回 unmatched

eg:

idInfo('350104############').getCounty()
# 仓山区

😄 获取年龄信息

.getAge()

返回对应身份证号码匹配的年龄 int

eg:

idInfo('35010419860321####').getAge()
# 35

😄 获取性别信息

.getSex()

返回对应身份证号码匹配的性别 str

eg:

idInfo('350104198603210047').getSex()
# 女

😄 获取生日信息

.getBirthDay()

返回对应身份证号码匹配的生日 str

eg:

idInfo('350104198603210047').getBirthDay()
# 19860321

😄 合法性检验

.isLegal()

检查对应身份证号码是否合法 int,返回 0 代表不合法,1 代表合法

eg:

idInfo('350104198603210047').isLegal()
# 0

📄 TODO

  • 异常处理