Class IdcardUtil

java.lang.Object
com.sure.tool.util.IdcardUtil

public class IdcardUtil extends Object
身份证号码工具类(中国大陆 15/18 位),参考 Hutool 的 IdcardUtil 设计。 支持合法性校验、15 位转 18 位、出生日期与性别解析。

English: Chinese ID-card validation and field extraction helpers.

Since:
0.1.0
Author:
suretool
  • Method Details

    • isValidCard

      public static boolean isValidCard(String idCard)
      校验身份证号码是否合法(支持 15/18 位)。
      Parameters:
      idCard - 身份证号码
      Returns:
      是否合法
    • isValidCard18

      public static boolean isValidCard18(String idCard)
      校验 18 位身份证(含校验码校验)。
      Parameters:
      idCard - 身份证号码
      Returns:
      是否合法
    • isValidCard15

      public static boolean isValidCard15(String idCard)
      校验 15 位身份证(仅校验出生日期合法性,15 位无校验码)。
      Parameters:
      idCard - 身份证号码
      Returns:
      是否合法
    • convert15To18

      public static String convert15To18(String idCard)
      15 位身份证转 18 位。
      Parameters:
      idCard - 15 位身份证号码
      Returns:
      18 位身份证号码
      Throws:
      IllegalArgumentException - 号码不合法时抛出
    • calculateCheckCode

      public static char calculateCheckCode(String idCard17)
      根据前 17 位计算校验码。
      Parameters:
      idCard17 - 前 17 位
      Returns:
      校验码(0-9 或 X)
      Throws:
      IllegalArgumentException - 长度不是 17 位时抛出
    • getBirthDate

      public static String getBirthDate(String idCard)
      获取出生日期(yyyy-MM-dd)。
      Parameters:
      idCard - 身份证号码
      Returns:
      出生日期,号码不合法返回 null
    • getGender

      public static String getGender(String idCard)
      获取性别(倒数第二位奇数男、偶数女)。
      Parameters:
      idCard - 身份证号码
      Returns:
      "男" / "女",号码不合法返回 null
    • getProvinceCode

      public static String getProvinceCode(String idCard)
      获取省份编码(前两位)。
      Parameters:
      idCard - 身份证号码
      Returns:
      省份编码,号码不合法返回 null
    • getAge

      public static int getAge(String idCard)
      计算周岁年龄。
      Parameters:
      idCard - 身份证号码
      Returns:
      年龄(周岁),号码不合法返回 -1