# js-idcard

**Repository Path**: chenbool/js-idcard

## Basic Information

- **Project Name**: js-idcard
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-03-26
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# js-idcard

中国身份证号码验证工具，支持 15 位和 18 位身份证的验证与信息解析。

## 功能

| 功能 | 说明 |
|------|------|
| 格式验证 | 验证身份证长度和格式 |
| 校验位验证 | 根据 GB 11643-1999 验证校验码 |
| 地区解析 | 根据前两位代码获取省份 |
| 出生日期 | 提取并验证出生年月日 |
| 性别判断 | 根据第 15/17 位奇偶判断 |
| 年龄计算 | 根据出生日期计算当前年龄 |

## 使用

```typescript
import { IDCard } from './IDCard';

let idCard = new IDCard('371325199509093045');
let rs = idCard.check();
console.log(rs);
```

## API

| 方法 | 说明 | 返回值 |
|------|------|--------|
| check() | 验证身份证并返回所有信息 | { status, message, data } |
| getArea() | 获取所属地区 | { status, message } |
| getBirthday() | 获取出生日期 | { status, message } |
| getSex() | 获取性别 | { status, message } |
| getAge() | 计算年龄 | { status, message } |
| getLenth() | 验证长度 | { status, message } |
| validate() | 验证校验位 | { status, message } |

## 地区编码

| 代码 | 地区 | 代码 | 地区 |
|------|------|------|------|
| 11 | 北京 | 44 | 广东 |
| 12 | 天津 | 45 | 广西 |
| 13 | 河北 | 46 | 海南 |
| 14 | 山西 | 50 | 重庆 |
| 15 | 内蒙古 | 51 | 四川 |
| 21 | 辽宁 | 52 | 贵州 |
| 22 | 吉林 | 53 | 云南 |
| 23 | 黑龙江 | 54 | 西藏 |
| 31 | 上海 | 61 | 陕西 |
| 32 | 江苏 | 62 | 甘肃 |
| 33 | 浙江 | 63 | 青海 |
| 34 | 安徽 | 64 | 宁夏 |
| 35 | 福建 | 65 | 新疆 |
| 36 | 江西 | 71 | 台湾 |
| 37 | 山东 | 81 | 香港 |
| 41 | 河南 | 82 | 澳门 |
| 42 | 湖北 | 91 | 国外 |
| 43 | 湖南 | | |