Class IdcardUtil
java.lang.Object
com.sure.tool.util.IdcardUtil
身份证号码工具类(中国大陆 15/18 位),参考 Hutool 的
IdcardUtil 设计。
支持合法性校验、15 位转 18 位、出生日期与性别解析。
English: Chinese ID-card validation and field extraction helpers.
- Since:
- 0.1.0
- Author:
- suretool
-
Method Summary
Modifier and TypeMethodDescriptionstatic charcalculateCheckCode(String idCard17) 根据前 17 位计算校验码。static Stringconvert15To18(String idCard) 15 位身份证转 18 位。static int计算周岁年龄。static StringgetBirthDate(String idCard) 获取出生日期(yyyy-MM-dd)。static String获取性别(倒数第二位奇数男、偶数女)。static StringgetProvinceCode(String idCard) 获取省份编码(前两位)。static booleanisValidCard(String idCard) 校验身份证号码是否合法(支持 15/18 位)。static booleanisValidCard15(String idCard) 校验 15 位身份证(仅校验出生日期合法性,15 位无校验码)。static booleanisValidCard18(String idCard) 校验 18 位身份证(含校验码校验)。
-
Method Details
-
isValidCard
校验身份证号码是否合法(支持 15/18 位)。- Parameters:
idCard- 身份证号码- Returns:
- 是否合法
-
isValidCard18
校验 18 位身份证(含校验码校验)。- Parameters:
idCard- 身份证号码- Returns:
- 是否合法
-
isValidCard15
校验 15 位身份证(仅校验出生日期合法性,15 位无校验码)。- Parameters:
idCard- 身份证号码- Returns:
- 是否合法
-
convert15To18
15 位身份证转 18 位。- Parameters:
idCard- 15 位身份证号码- Returns:
- 18 位身份证号码
- Throws:
IllegalArgumentException- 号码不合法时抛出
-
calculateCheckCode
根据前 17 位计算校验码。- Parameters:
idCard17- 前 17 位- Returns:
- 校验码(0-9 或 X)
- Throws:
IllegalArgumentException- 长度不是 17 位时抛出
-
getBirthDate
-
getGender
-
getProvinceCode
-
getAge
计算周岁年龄。- Parameters:
idCard- 身份证号码- Returns:
- 年龄(周岁),号码不合法返回 -1
-