简体中文 | English

特性

| 特性 | 说明 | | --------------- | ------------------------------ | | 0 依赖 | 无任何第三方依赖，安全可靠 | | 格式验证 | 检查身份证基本格式（15/18位） | | 省份校验 | 验证省份代码有效性 | | 校验码验证 | 使用加权算法验证校验位 | | 15/18位转换 | 支持相互转换 | | 信息解析 | 解析省份、出生日期、性别、年龄 | | 脱敏处理 | 隐藏部分身份证号码 |

安装

pnpm add china-id-card

快速开始

import { isValid, parse, mask } from 'china-id-card';

// 解析身份证信息
const info = parse('622922197808118498');
// → { isValid: true, province: '甘肃省', birthDate: '1978-08-11', gender: 'male', age: 46, ... }

// 快速验证
isValid('622922197808118498'); // → true

// 脱敏处理
mask('622922197808118498'); // → '622***********8498'

API 参考

核心函数

| 函数 | 返回类型 | 说明 | | ------------------ | ---------------- | ------------------------ | | isValid(id) | boolean | 快速验证身份证是否有效 | | parse(id) | IDCardInfo | 解析完整身份证信息 | | mask(id) | string | 脱敏处理（显示前3后4位） | | toEighteen(id) | string \| null | 15位转18位 | | getCheckCode(id) | string \| null | 计算校验码 |

校验函数

| 函数 | 返回类型 | 说明 | | --------------------- | --------- | ------------ | | checkBaseFormat(id) | boolean | 检验基本格式 | | checkProvince(id) | boolean | 检验省份代码 |

IDCardInfo 类型

interface IDCardInfo {
  isValid: boolean; // 身份证是否有效
  provinceCode: string; // 省份代码 (如: '62')
  province: string; // 省份名称 (如: '甘肃省')
  birthDate: string; // 出生日期 (YYYY-MM-DD)
  gender: 'male' | 'female'; // 性别
  age: number; // 年龄
  fifteenDigit: string | null; // 15位身份证
  eighteenDigit: string | null; // 18位身份证
}

许可证

MIT License

Made by tonyc726