身份证工具 - IdcardUtil

简介

在实际开发中，我们经常需要对身份证号码进行校验。中国大陆的身份证号码分为 15 位和 18 位两种，其中 18 位身份证的每一位都有严格的规则，特别是最后一位是校验位。为了简化身份证校验、提取信息等操作，IdcardUtil 提供了一系列便捷方法。

1. isValidCard 验证身份证是否合法

isValidCard 方法用于判断传入的身份证号码是否合法，支持 15 位和 18 位身份证号码，以及港澳台的 10 位身份证。

import cn.hutool.core.util.IdcardUtil;

public class IdcardUtilExample {
    public static void main(String[] args) {
        String id18 = "321083197812162119";
        String id15 = "150102880730303";

        // 验证 18 位身份证号是否合法
        boolean isValid18 = IdcardUtil.isValidCard(id18);
        System.out.println("18 位身份证是否有效: " + isValid18); // true

        // 验证 15 位身份证号是否合法
        boolean isValid15 = IdcardUtil.isValidCard(id15);
        System.out.println("15 位身份证是否有效: " + isValid15); // true
    }
}

• isValidCard(String idCard)：判断身份证号是否合法。
  • idCard：身份证号码。
  • 返回值：true 如果身份证号合法。

作用： 该方法用于对用户输入的身份证号码进行合法性校验，确保号码格式正确。

实际开发场景： 在用户注册、身份验证等场景中，可以使用此方法确保身份证号的格式和内容符合国家标准。

2. convert15To18 身份证 15 位转 18 位

15 位的身份证号码可以通过加权转换为 18 位号码，convert15To18 方法提供了这种转换的功能。

import cn.hutool.core.util.IdcardUtil;

public class IdcardUtilExample {
    public static void main(String[] args) {
        String id15 = "150102880730303";

        // 将 15 位身份证号转换为 18 位
        String id18 = IdcardUtil.convert15To18(id15);
        System.out.println("转换后的 18 位身份证号: " + id18); // 150102198807303035
    }
}

• convert15To18(String idCard)：将 15 位身份证号转换为 18 位。
  • idCard：15 位身份证号码。
  • 返回值：转换后的 18 位身份证号码。

作用： 用于处理旧版 15 位身份证，自动转换为 18 位格式，以便与现行标准一致。

实际开发场景： 在用户信息管理中，如果用户提供的是 15 位身份证号，可以使用此方法进行自动转换，确保信息的统一性。

3. getBirthByIdCard 获取身份证中的生日

身份证号码中包含了出生日期信息，getBirthByIdCard 方法可以直接提取出生日期。

import cn.hutool.core.util.IdcardUtil;

public class IdcardUtilExample {
    public static void main(String[] args) {
        String id18 = "321083197812162119";

        // 获取身份证中的出生日期
        String birthDate = IdcardUtil.getBirthByIdCard(id18);
        System.out.println("身份证中的出生日期: " + birthDate); // 19781216
    }
}

• getBirthByIdCard(String idCard)：从身份证号中提取出生日期。
  • idCard：身份证号码。
  • 返回值：出生日期，格式为 yyyyMMdd。

作用： 快速提取身份证中的生日信息，无需手动解析字符串。

实际开发场景： 在用户注册、信息录入等场景中，可以自动提取用户的出生日期，减少手动输入的错误。

4. getAgeByIdCard 获取身份证中的年龄

根据身份证号码中的出生日期，可以直接计算出用户的当前年龄，getAgeByIdCard 方法提供了这一功能。

import cn.hutool.core.util.IdcardUtil;
import cn.hutool.core.date.DateUtil;

public class IdcardUtilExample {
    public static void main(String[] args) {
        String id18 = "321083197812162119";

        // 使用当前日期计算年龄
        int age = IdcardUtil.getAgeByIdCard(id18);
        System.out.println("身份证对应的年龄: " + age); // 可能是45岁（根据当前年份）

        // 使用指定日期计算年龄
        int ageOnDate = IdcardUtil.getAgeByIdCard(id18, DateUtil.parse("2025-01-01"));
        System.out.println("2025年时的年龄: " + ageOnDate); // 可能是46岁（根据出生日期）
    }
}

• getAgeByIdCard(String idCard)：根据身份证号计算当前年龄。

  • idCard：身份证号码。
  • 返回值：年龄。

• getAgeByIdCard(String idCard, Date date)：根据身份证号和指定日期计算年龄。

  • idCard：身份证号码。
  • date：指定计算的日期。
  • 返回值：年龄。

作用： 自动计算用户年龄，省去手动计算的麻烦。

实际开发场景： 在用户信息展示或分析中，可以使用此方法直接显示用户的年龄，确保信息的实时准确性。

5. 其他常用方法

• getYearByIdCard(String idCard)：获取身份证中的出生年份。

  int birthYear = IdcardUtil.getYearByIdCard("321083197812162119");
  System.out.println("出生年份: " + birthYear); // 1978
  

• getMonthByIdCard(String idCard)：获取身份证中的出生月份。

  int birthMonth = IdcardUtil.getMonthByIdCard("321083197812162119");
  System.out.println("出生月份: " + birthMonth); // 12
  

• getDayByIdCard(String idCard)：获取身份证中的出生日期（天）。

  int birthDay = IdcardUtil.getDayByIdCard("321083197812162119");
  System.out.println("出生日期: " + birthDay); // 16
  

• getGenderByIdCard(String idCard)：获取身份证中的性别。

  String gender = IdcardUtil.getGenderByIdCard("321083197812162119");
  System.out.println("性别: " + gender); // 男性
  

• getProvinceByIdCard(String idCard)：获取身份证中的省份信息。

  String province = IdcardUtil.getProvinceByIdCard("321083197812162119");
  System.out.println("省份: " + province); // 江苏
  

作用： 这些方法可以快速从身份证号码中提取各种信息，避免手动解析字符串的繁琐和出错。

实际开发场景： 在用户注册、信息录入、用户画像等场景中，这些方法可以帮助我们快速提取用户的关键信息，提高工作效率。

通过 IdcardUtil，我们能够快速、准确地对身份证号码进行验证和解析，确保信息的完整性和可靠性。