@hzab/utils 1.0.10 → 1.0.11-beta.0

package/changelog.md

@@ -1,3 +1,7 @@
+# @hzab/utils@1.0.11
+
+feat: 身份证校验合法性
+
 # @hzab/utils@1.0.10
 
 feat:缩略图全局配置

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hzab/utils",
-  "version": "1.0.10",
+  "version": "1.0.11-beta.0",
   "description": "utils",
   "main": "src",
   "scripts": {

package/src/idCardVerify.ts

@@ -0,0 +1,238 @@
+/**
+ * 身份证号码合法性校验
+ * @param {string} idCard 身份证号码
+ * @param {Object} opt 校验选项
+ * @param {boolean} opt.validBirthDate 是否校验出生日期
+ * @returns {boolean} 是否合法
+ */
+export function isValidIdCard(idCard, opt?) {
+  // 空值校验
+  if (!idCard) return false;
+
+  // 去除空格
+  idCard = idCard.trim().toUpperCase();
+
+  // 长度校验
+  const len = idCard.length;
+  if (len !== 15 && len !== 18) return false;
+
+  // 15位身份证正则（仅数字，出生日期格式为YYMMDD）
+  const reg15 = /^[1-9]\d{7}((0[1-9])|(1[0-2]))((0[1-9])|([1-2]\d)|(3[0-1]))\d{3}$/;
+  // 18位身份证正则（前17位数字，最后一位可能是数字或X）
+  const reg18 = /^[1-9]\d{5}(18|19|20)\d{2}((0[1-9])|(1[0-2]))((0[1-9])|([1-2]\d)|(3[0-1]))\d{3}[\dX]$/;
+
+  // 格式校验
+  if (len === 15 && !reg15.test(idCard)) return false;
+  if (len === 18 && !reg18.test(idCard)) return false;
+
+  // 15位转18位后校验校验码
+  let id18 = idCard;
+  if (len === 15) {
+    id18 = convert15to18(idCard);
+  }
+
+  // 校验地址码（省级+市级）
+  if (!isValidAddressCode(id18)) return false;
+
+  // 校验出生日期是否在合理范围内（1900年-当前年份）
+  if (opt?.validBirthDate && !isValidBirthDate(id18)) return false;
+
+  // 校验最后一位校验码
+  return verifyCheckCode(id18);
+}
+
+/**
+ * 校验地址码（前6位）
+ * 规则校验：省级代码合法 + 市级代码格式合法
+ */
+export function isValidAddressCode(id18) {
+  const addrCode = id18.substring(0, 6);
+
+  const provinceCode = addrCode.substring(0, 2);
+  const cityCode = addrCode.substring(2, 4);
+
+  // 1. 校验省级代码（第1-2位）
+  if (!isValidProvinceCode(provinceCode)) return false;
+
+  // 2. 校验市级代码（第3-4位）
+  if (!isValidCityCode(cityCode)) return false;
+
+  return true;
+}
+
+/**
+ * 校验省级代码（第1-2位）
+ * 合法范围：11-15, 21-23, 31-37, 41-46, 50-54, 61-65, 71, 81, 82
+ */
+function isValidProvinceCode(code) {
+  const pattern = /^(1[1-5]|2[1-3]|3[1-7]|4[1-3]|4[4-6]|5[0-4]|6[1-5]|71|81|82)$/;
+  return pattern.test(code);
+}
+
+/**
+ * 校验市级代码（第3-4位）
+ * 规则：
+ * - 01-20：常规地级市、自治州、地区、盟
+ * - 51-59：地区（历史遗留）
+ * - 90：省直辖县级市/县
+ * - 不能是00
+ */
+function isValidCityCode(code) {
+  const pattern = /^(0[1-9]|1[0-9]|20|5[1-9]|90)$/;
+  return pattern.test(code);
+}
+
+/**
+ * 校验出生日期是否合法且在一定范围内
+ * @param {string} id18 18位身份证号码
+ * @returns {boolean} 出生日期是否合法
+ */
+export function isValidBirthDate(id18) {
+  // 提取出生日期信息
+  const birthYear = parseInt(id18.substring(6, 10));
+  const birthMonth = parseInt(id18.substring(10, 12));
+  const birthDay = parseInt(id18.substring(12, 14));
+
+  const currentYear = new Date().getFullYear();
+
+  // 年份范围校验：1900年到当前年份（包含）
+  if (birthYear < 1900 || birthYear > currentYear) {
+    return false;
+  }
+
+  // 月份范围校验
+  if (birthMonth < 1 || birthMonth > 12) {
+    return false;
+  }
+
+  // 日期范围校验（考虑闰年）
+  const daysInMonth = getDaysInMonth(birthYear, birthMonth);
+
+  if (birthDay < 1 || birthDay > daysInMonth) {
+    return false;
+  }
+
+  return true;
+}
+
+/**
+ * 获取指定月份的天数
+ * @param {number} year 年份
+ * @param {number} month 月份（1-12）
+ * @returns {number} 该月的天数
+ */
+export function getDaysInMonth(year, month) {
+  // 闰年判断：能被4整除但不能被100整除，或者能被400整除
+  const isLeapYear = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+
+  const daysInMonth = [31, isLeapYear ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  return daysInMonth[month - 1];
+}
+
+/**
+ * 15位身份证转18位
+ * @param {string} id15 15位身份证号码
+ * @returns {string} 18位身份证号码
+ */
+export function convert15to18(id15) {
+  // 提取15位中的年份（两位）
+  const yearTwoDigits = parseInt(id15.substring(6, 8));
+  // 年份范围判断：如果两位年份大于当前年份的后两位，则属于1900年代，否则属于2000年代
+  const currentYear = new Date().getFullYear();
+  const currentYearTwoDigits = currentYear % 100;
+
+  let fullYear;
+  if (yearTwoDigits > currentYearTwoDigits) {
+    fullYear = 1900 + yearTwoDigits;
+  } else {
+    fullYear = 2000 + yearTwoDigits;
+  }
+
+  // 年份前加完整的四位年份
+  let id17 = id15.substring(0, 6) + fullYear + id15.substring(8);
+  // 计算校验码
+  const checkCode = calculateCheckCode(id17);
+  return id17 + checkCode;
+}
+
+/**
+ * 计算18位身份证的校验码
+ * @param {string} id17 身份证前17位
+ * @returns {string} 校验码（0-9或X）
+ */
+export function calculateCheckCode(id17) {
+  // 加权因子
+  const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+  // 校验码对应值
+  const checkCodes = ["1", "0", "X", "9", "8", "7", "6", "5", "4", "3", "2"];
+
+  let sum = 0;
+  for (let i = 0; i < 17; i++) {
+    sum += parseInt(id17[i]) * weights[i];
+  }
+  const mod = sum % 11;
+  return checkCodes[mod];
+}
+
+/**
+ * 校验18位身份证的校验码
+ * @param {string} id18 18位身份证号码
+ * @returns {boolean} 校验码是否正确
+ */
+export function verifyCheckCode(id18) {
+  const id17 = id18.substring(0, 17);
+  const providedCode = id18[17];
+  const calculatedCode = calculateCheckCode(id17);
+  return providedCode === calculatedCode;
+}
+
+/**
+ * 计算年龄
+ * @param {number} year 出生年份
+ * @param {number} month 出生月份
+ * @param {number} day 出生日期
+ * @returns {number} 年龄
+ */
+export function calculateAge(year, month, day) {
+  const today = new Date();
+  let age = today.getFullYear() - year;
+  const monthDiff = today.getMonth() + 1 - month;
+  if (monthDiff < 0 || (monthDiff === 0 && today.getDate() < day)) {
+    age--;
+  }
+  return age;
+}
+
+/**
+ * 获取身份证详细信息
+ * @param {string} idCard 身份证号码
+ * @returns {object|null} 详细信息对象，校验失败返回null
+ */
+export function getIdCardInfo(idCard) {
+  if (!isValidIdCard(idCard)) return null;
+
+  let id18 = idCard.trim().toUpperCase();
+  if (id18.length === 15) {
+    id18 = convert15to18(id18);
+  }
+
+  // 解析信息
+  const provinceCode = id18.substring(0, 2);
+  const birthYear = parseInt(id18.substring(6, 10));
+  const birthMonth = parseInt(id18.substring(10, 12));
+  const birthDay = parseInt(id18.substring(12, 14));
+  const genderCode = parseInt(id18.substring(16, 17));
+
+  const birthDate = new Date(birthYear, birthMonth - 1, birthDay);
+
+  return {
+    province: provinceCode,
+    birthDate: birthDate,
+    birthYear: birthYear,
+    birthMonth: birthMonth,
+    birthDay: birthDay,
+    age: calculateAge(birthYear, birthMonth, birthDay),
+    gender: genderCode % 2 === 1 ? "男" : "女",
+    isValid: true,
+  };
+}