https://github.com/jxlwqq/id-validator.py
中华人民共和国居民身份证、中华人民共和国港澳居民居住证以及中华人民共和国台湾居民居住证号码验证工具（Python 版）
https://github.com/jxlwqq/id-validator.py
id-validator
Last synced: about 1 year ago
JSON representation
中华人民共和国居民身份证、中华人民共和国港澳居民居住证以及中华人民共和国台湾居民居住证号码验证工具（Python 版）
- Host: GitHub
- URL: https://github.com/jxlwqq/id-validator.py
- Owner: jxlwqq
- License: mit
- Created: 2018-09-15T14:14:20.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-04-01T08:37:53.000Z (about 4 years ago)
- Last Synced: 2025-05-10T14:17:50.617Z (about 1 year ago)
- Topics: id-validator
- Language: Python
- Homepage: https://pypi.org/project/id-validator/
- Size: 459 KB
- Stars: 368
- Watchers: 8
- Forks: 85
- Open Issues: 10
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
**中华人民共和国居民身份证**\ 、\ **中华人民共和国港澳居民居住证**\ 以及\ **中华人民共和国台湾居民居住证**\ 号码验证工具（Python
版）支持 15 位与 18 位号码。仅支持 Python 3。
- `Go 版本 `__
- `PHP 版本 `__
- `Ruby 版本 `__
- `JavaScript 版本 `__
.. image:: https://github.com/jxlwqq/id-validator.py/actions/workflows/testing.yml/badge.svg
:target: https://github.com/jxlwqq/id-validator.py/actions/workflows/testing.yml
安装
----
.. code:: bash
pip install id-validator
使用
----
``440308199901101512`` 和 ``610104620927690``
示例大陆居民身份证均为随机生成的假数据，如撞车，请联系删除。
``810000199408230021`` 和 ``830000199201300022``
示例港澳台居民居住证为北京市公安局公布的居住证样式号码。
验证身份证号合法性
~~~~~~~~~~~~~~~~~~
验证身份证号是否合法，合法返回 ``True``\ ，不合法返回 ``False``\ ：
.. code:: python
from id_validator import validator
validator.is_valid('440308199901101512') # 大陆居民身份证 18 位
validator.is_valid('610104620927690') # 大陆居民身份证 15 位
validator.is_valid('810000199408230021') # 港澳居民居住证 18 位
validator.is_valid('830000199201300022') # 台湾居民居住证 18 位
获取身份证号信息
~~~~~~~~~~~~~~~~
当身份证号合法时，返回分析信息（地区、出生日期、星座、生肖、性别、校验位），不合法返回
``False``\ ：
.. code:: python
from id_validator import validator
validator.get_info('440308199901101512') # 18 位
validator.get_info('610104620927690') # 15 位
返回信息格式如下：
.. code:: python
{
'address_code' : '440308', # 地址码
'abandoned' : 0, # 地址码是否废弃，1 为废弃的，0 为正在使用的
'address' : '广东省深圳市盐田区', # 地址
'address_tree' : ['广东省', '深圳市', '盐田区'] # 省市区三级列表
'age' : 21, # 年龄，当前的年份减去出生年份，例：2020-1999=21
'birthday_code' : '1999-01-10', # 出生日期
'constellation' : '摩羯座', # 星座
'chinese_zodiac' : '卯兔', # 生肖
'sex' : 1, # 性别，1 为男性，0 为女性
'length' : 18, # 号码长度
'check_bit' : '2' # 校验码
}
..
注：判断地址码是否废弃的依据是\ `中华人民共和国行政区划代码历史数据集 `__\ ，本数据集的采集源来自：\ `中华人民共和国民政部 `__\ ，每年更新一次。本数据集采用
csv 格式存储，方便大家进行数据分析或者开发其他语言的版本。
生成可通过校验的假数据
~~~~~~~~~~~~~~~~~~~~~~
伪造符合校验的身份证：
.. code:: python
from id_validator import validator
validator.fake_id() # 18 位
validator.fake_id(False) # 15 位
validator.fake_id(True, '上海市', '2000', 1) # 生成出生于 2000 年上海市的男性居民身份证
validator.fake_id(True, '南山区', '1999', 0) # 生成出生于 1999 年广东省深圳市南山区的女性居民身份证
validator.fake_id(True, '江苏省', '200001', 1) # 生成出生于 2000 年 1 月江苏省的男性居民身份证
validator.fake_id(True, '厦门市', '199701', 0) # 生成出生于 1997 年 1 月福建省厦门市的女性居民身份证
validator.fake_id(True, '台湾省', '20131010', 0) # 生成出生于 2013 年 10 月 10 日台湾省的女性居民居住证
validator.fake_id(True, '香港特别行政区', '19970701', 0) # 生成出生于 1997 年 7 月 1 日香港特别行政区的女性居民居住证
身份证升级
~~~~~~~~~~~~~~~~~~~~~~
15 位号码升级为 18 位：
.. code:: python
from id_validator import validator
validator.upgrade_id('610104620927690')
参考资料
--------
- `中华人民共和国公民身份号码 `__
- `中华人民共和国民政部：行政区划代码 `__
- `中华人民共和国行政区划代码历史数据集 `__
- `国务院办公厅关于印发《港澳台居民居住证申领发放办法》的通知 `__
- `港澳台居民居住证 `__
Change Log
----------
- 1.0.10: get_info 返回值添加省市区三级列表
- 1.0.13: get_info 返回值添加年龄信息
License
-------
`MIT `__