254 lines
7.0 KiB
Dart
254 lines
7.0 KiB
Dart
// utils/id_card_util.dart
|
||
import 'dart:core';
|
||
|
||
class IDCardInfo {
|
||
final String raw;
|
||
final bool isValid;
|
||
final String? error;
|
||
final String? id18; // 标准化到18位（若输入15位则自动转换）
|
||
final String? provinceCode;
|
||
final String? province;
|
||
final DateTime? birthDate;
|
||
final String? birth; // YYYY-MM-DD
|
||
final int? age;
|
||
final String? gender; // '男' / '女'
|
||
final bool checksumValid;
|
||
final String? constellation; // 星座
|
||
final String? zodiac; // 生肖
|
||
|
||
IDCardInfo({
|
||
required this.raw,
|
||
required this.isValid,
|
||
this.error,
|
||
this.id18,
|
||
this.provinceCode,
|
||
this.province,
|
||
this.birthDate,
|
||
this.birth,
|
||
this.age,
|
||
this.gender,
|
||
required this.checksumValid,
|
||
this.constellation,
|
||
this.zodiac,
|
||
});
|
||
|
||
Map<String, dynamic> toJson() => {
|
||
'raw': raw,
|
||
'isValid': isValid,
|
||
'error': error,
|
||
'id18': id18,
|
||
'provinceCode': provinceCode,
|
||
'province': province,
|
||
'birth': birth,
|
||
'age': age,
|
||
'gender': gender,
|
||
'checksumValid': checksumValid,
|
||
'constellation': constellation,
|
||
'zodiac': zodiac,
|
||
};
|
||
|
||
@override
|
||
String toString() => toJson().toString();
|
||
}
|
||
|
||
/// 主要调用函数：传入身份证号字符串，返回 IDCardInfo
|
||
IDCardInfo parseChineseIDCard(String id) {
|
||
final raw = (id ?? '').toString().trim().toUpperCase();
|
||
if (raw.isEmpty) {
|
||
return IDCardInfo(raw: raw, isValid: false, error: '空字符串', checksumValid: false);
|
||
}
|
||
|
||
// 省份码映射（常见）
|
||
const provinceMap = <String, String>{
|
||
'11': '北京市',
|
||
'12': '天津市',
|
||
'13': '河北省',
|
||
'14': '山西省',
|
||
'15': '内蒙古自治区',
|
||
'21': '辽宁省',
|
||
'22': '吉林省',
|
||
'23': '黑龙江省',
|
||
'31': '上海市',
|
||
'32': '江苏省',
|
||
'33': '浙江省',
|
||
'34': '安徽省',
|
||
'35': '福建省',
|
||
'36': '江西省',
|
||
'37': '山东省',
|
||
'41': '河南省',
|
||
'42': '湖北省',
|
||
'43': '湖南省',
|
||
'44': '广东省',
|
||
'45': '广西壮族自治区',
|
||
'46': '海南省',
|
||
'50': '重庆市',
|
||
'51': '四川省',
|
||
'52': '贵州省',
|
||
'53': '云南省',
|
||
'54': '西藏自治区',
|
||
'61': '陕西省',
|
||
'62': '甘肃省',
|
||
'63': '青海省',
|
||
'64': '宁夏回族自治区',
|
||
'65': '新疆维吾尔自治区',
|
||
'71': '台湾省',
|
||
'81': '香港特别行政区',
|
||
'82': '澳门特别行政区',
|
||
'91': '国外'
|
||
};
|
||
|
||
// 校验正则：15 位全数字；18 位前17 数字 + 最后一位数字或 X
|
||
final reg15 = RegExp(r'^\d{15}$');
|
||
final reg18 = RegExp(r'^\d{17}[\dX]$');
|
||
|
||
String standardized = raw;
|
||
bool convertedFrom15 = false;
|
||
if (reg15.hasMatch(raw)) {
|
||
// 15 位 -> 转 18 位（在第6位后插入 "19"），然后计算校验位
|
||
final prefix17 = raw.substring(0, 6) + '19' + raw.substring(6);
|
||
final checkChar = _calcCheckChar(prefix17);
|
||
standardized = prefix17 + checkChar;
|
||
convertedFrom15 = true;
|
||
} else if (reg18.hasMatch(raw)) {
|
||
standardized = raw;
|
||
} else {
|
||
return IDCardInfo(
|
||
raw: raw,
|
||
isValid: false,
|
||
error: '身份证格式不正确（不是15位或18位）',
|
||
checksumValid: false,
|
||
);
|
||
}
|
||
|
||
// 取出生日期
|
||
final birthStr = standardized.substring(6, 14); // YYYYMMDD
|
||
final year = int.tryParse(birthStr.substring(0, 4));
|
||
final month = int.tryParse(birthStr.substring(4, 6));
|
||
final day = int.tryParse(birthStr.substring(6, 8));
|
||
|
||
if (year == null || month == null || day == null) {
|
||
return IDCardInfo(
|
||
raw: raw,
|
||
isValid: false,
|
||
error: '无法解析出生日期',
|
||
id18: standardized,
|
||
checksumValid: _verifyCheck(standardized),
|
||
);
|
||
}
|
||
|
||
// 校验日期是否真实存在（例如闰年等）
|
||
DateTime? birthDate;
|
||
try {
|
||
birthDate = DateTime(year, month, day);
|
||
// 额外检查同一天
|
||
if (birthDate.year != year || birthDate.month != month || birthDate.day != day) {
|
||
birthDate = null;
|
||
}
|
||
} catch (e) {
|
||
birthDate = null;
|
||
}
|
||
|
||
if (birthDate == null) {
|
||
return IDCardInfo(
|
||
raw: raw,
|
||
isValid: false,
|
||
error: '出生日期无效',
|
||
id18: standardized,
|
||
checksumValid: _verifyCheck(standardized),
|
||
);
|
||
}
|
||
|
||
// 年龄计算（按生日是否已过来算）
|
||
final now = DateTime.now();
|
||
int age = now.year - birthDate.year;
|
||
if (now.month < birthDate.month || (now.month == birthDate.month && now.day < birthDate.day)) {
|
||
age -= 1;
|
||
}
|
||
|
||
// 性别：第 17 位（索引 16）为序列码的最后一位，奇数男 偶数女
|
||
final seq = standardized.substring(14, 17); // 3 位序列号
|
||
final seqNum = int.tryParse(seq);
|
||
final gender = (seqNum != null && seqNum % 2 == 1) ? '男' : '女';
|
||
|
||
// 省份
|
||
final provinceCode = standardized.substring(0, 2);
|
||
final province = provinceMap[provinceCode] ?? '未知';
|
||
|
||
// 校验位验证
|
||
final checksumValid = _verifyCheck(standardized);
|
||
|
||
// 星座与生肖
|
||
final constellation = _calcConstellation(birthDate.month, birthDate.day);
|
||
final zodiac = _calcChineseZodiac(birthDate.year);
|
||
|
||
return IDCardInfo(
|
||
raw: raw,
|
||
isValid: true,
|
||
id18: standardized,
|
||
provinceCode: provinceCode,
|
||
province: province,
|
||
birthDate: birthDate,
|
||
birth: '${birthDate.year.toString().padLeft(4, '0')}-${birthDate.month.toString().padLeft(2, '0')}-${birthDate.day.toString().padLeft(2, '0')}',
|
||
age: age,
|
||
gender: gender,
|
||
checksumValid: checksumValid,
|
||
constellation: constellation,
|
||
zodiac: zodiac,
|
||
);
|
||
}
|
||
|
||
// ---- 辅助函数 ----
|
||
|
||
// 计算 17 位前缀的校验码（返回 '0'-'9' 或 'X'）
|
||
String _calcCheckChar(String id17) {
|
||
// 权重
|
||
const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
|
||
// 校验码映射 remainder -> char
|
||
const checkMap = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];
|
||
|
||
int sum = 0;
|
||
for (var i = 0; i < 17; i++) {
|
||
final ch = id17[i];
|
||
final n = int.tryParse(ch) ?? 0;
|
||
sum += n * weights[i];
|
||
}
|
||
final mod = sum % 11;
|
||
return checkMap[mod];
|
||
}
|
||
|
||
// 验证完整 18 位身份证的校验位是否正确
|
||
bool _verifyCheck(String id18) {
|
||
if (id18.length != 18) return false;
|
||
final id17 = id18.substring(0, 17);
|
||
final expected = _calcCheckChar(id17);
|
||
final actual = id18[17].toUpperCase();
|
||
return expected == actual;
|
||
}
|
||
|
||
// 计算星座（西方）
|
||
String _calcConstellation(int month, int day) {
|
||
const names = [
|
||
'摩羯座', '水瓶座', '双鱼座', '白羊座', '金牛座', '双子座',
|
||
'巨蟹座', '狮子座', '处女座', '天秤座', '天蝎座', '射手座'
|
||
];
|
||
const startDays = [20, 19, 21, 21, 21, 22, 23, 23, 23, 23, 22, 22];
|
||
// 月份从1开始
|
||
final idx = (month - 1);
|
||
if (day < startDays[idx]) {
|
||
return names[(idx + 11) % 12];
|
||
} else {
|
||
return names[idx];
|
||
}
|
||
}
|
||
|
||
// 计算生肖（中国农历生肖按公历年对照，简化算法）
|
||
String _calcChineseZodiac(int year) {
|
||
const zodiacs = [
|
||
'鼠', '牛', '虎', '兔', '龙', '蛇', '马', '羊', '猴', '鸡', '狗', '猪'
|
||
];
|
||
// 1900 是鼠年（可以用任意基准）
|
||
final idx = (year - 1900) % 12;
|
||
final i = idx < 0 ? (idx + 12) % 12 : idx;
|
||
return zodiacs[i];
|
||
}
|