更新记录

1.0.0（2025-06-05）

• 身份证号码解析：提取身份证号码中的省市区、出生日期、性别等信息。
• 支持多种证件类型：
  • 中国居民身份证
  • 港澳台居民居住证
  • 外国人永久居留身份证
• 纯UTS实现：可在uni-app x及支持UTS的环境中使用。

平台兼容性

uni-app(4.65)

uni-app x(4.65)

其他

nutpi-idcard

一个用于解析身份证号码的UTS插件，支持中国居民身份证、港澳台居民居住证以及外国人永久居留身份证。

功能特性

• 身份证号码解析：提取身份证号码中的省市区、出生日期、性别等信息。
• 支持多种证件类型：
  • 中国居民身份证
  • 港澳台居民居住证
  • 外国人永久居留身份证
• 纯UTS实现：可在uni-app x及支持UTS的环境中使用。

如何使用

1. 引入插件：在需要使用的页面或组件中引入插件。

   import { parseID } from '@/uni_modules/nutpi-idcard';

2. 调用解析函数：使用 parseID 函数解析身份证号码。

   const idNumber = '身份证号码'; // 替换为实际的身份证号码
   const idInfo = parseID(idNumber);
   console.log(idInfo);

API

parseID(id: string): IDResult

解析身份证号码并返回包含详细信息的对象。

• 参数：
  • id: string - 需要解析的身份证号码。
• 返回值：IDResult 对象，包含以下属性：
  • type?: string - 证件类型（例如：'居民身份证', '外国人永久居留身份证', '港澳台居民居住证', '未知类型'）。
  • sign?: string - 签发机关或地区信息。
  • country?: string - 国家或地区（例如：'中国', '无国籍' 或其他国家名称）。
  • birthday?: string - 出生日期，格式为 'YYYY-MM-DD'。
  • sex?: string - 性别（'男' 或 '女'）。
  • isValid?: boolean - 身份证号码是否有效（当前版本简单返回true，待实现详细校验逻辑）。

IDResult 接口

export interface IDResult {
    type?: string;
    sign?: string;
    country?: string;
    birthday?: string;
    sex?: string;
    isValid?: boolean;
}

开发文档参考

• UTS 语法
• UTS API插件
• UTS uni-app兼容模式组件
• UTS 标准模式组件
• Hello UTS

作者信息

• 作者：坚果派
• 公众号：nutpi
• 电话：
• 官网：https://www.nutpi.net/