com.lmaye.app.common.utils

类 IDCardUtils

java.lang.Object

com.lmaye.app.common.utils.IDCardUtils

public final class IDCardUtils
extends Object

-- 身份证工具

从以下版本开始:

2020-12-01 15:23:22

作者:

lmay.Zhou

字段概要

字段

限定符和类型	字段和说明
static String	BIRTH_DATE_FORMAT 身份证号码中的出生日期的格式
static Date	MINIMAL_BIRTH_DATE 身份证的最小出生日期,1900年1月1日
static int	NEW_CARD_NUMBER_LENGTH
static int	OLD_CARD_NUMBER_LENGTH
static char[]	VERIFY_CODE 18位身份证中最后一位校验码
static int[]	VERIFY_CODE_WEIGHT 18位身份证中，各个数字的生成校验码时的权值

构造器概要

构造器

构造器和说明
IDCardUtils()

方法概要

限定符和类型	方法和说明
static char	calculateVerifyCode(CharSequence cardNumber) 校验码（第十八位数）： 十七位数字本体码加权求和公式 S = Sum(Ai * Wi), i = 0...16 ，先对前17位数字的权求和； Ai:表示第i位置上的身份证号码数字值 Wi:表示第i位置上的加权因子 Wi: 7 9 10 5 8 4 2 1 6 3 7 9 10 5 8 4 2； 计算模 Y = mod(S, 11) 通过模得到对应的校验码 Y: 0 1 2 3 4 5 6 7 8 9 10 校验码: 1 0 X 9 8 7 6 5 4 3 2
static String	convertToNewCardNumber(String cardNumber) 把15位身份证号码转换到18位身份证号码 15位身份证号码与18位身份证号码的区别为： 1、15位身份证号码中，"出生年份"字段是2位，转换时需要补入"19"，表示20世纪 2、15位身份证无最后一位校验码。
static SimpleDateFormat	createBirthDateParser() 格式化出生日期
static String	getAddressCode(String cardNumber) 获取地址编码
static int	getAgeFromBirthTime(Date birthDate) 根据年月日计算年龄
static int	getAgeFromBirthTime(long birthTimeLong) 根据时间戳计算年龄
static Date	getBirthDate(String cardNumber) 获取出生日期
static String	getBirthDayPart(String cardNumber) 获取出生日期字符串
static int	getGenderCode(String cardNumber) 获取身份证的第17位，奇数为男性，偶数为女性
static boolean	isFemale(String cardNumber) 女
static boolean	isMale(String cardNumber) 男
static boolean	validate(String cardNumber) 校验身份证号码

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

BIRTH_DATE_FORMAT

public static final String BIRTH_DATE_FORMAT

身份证号码中的出生日期的格式

另请参阅:

常量字段值

MINIMAL_BIRTH_DATE

public static final Date MINIMAL_BIRTH_DATE

身份证的最小出生日期,1900年1月1日

NEW_CARD_NUMBER_LENGTH

public static final int NEW_CARD_NUMBER_LENGTH

另请参阅:

常量字段值

OLD_CARD_NUMBER_LENGTH

public static final int OLD_CARD_NUMBER_LENGTH

另请参阅:

常量字段值

VERIFY_CODE

public static final char[] VERIFY_CODE

18位身份证中最后一位校验码

VERIFY_CODE_WEIGHT

public static final int[] VERIFY_CODE_WEIGHT

18位身份证中，各个数字的生成校验码时的权值

构造器详细资料

IDCardUtils

public IDCardUtils()

方法详细资料

validate

public static boolean validate(String cardNumber)

校验身份证号码

参数:

cardNumber - 身份证号码

返回:

boolean

getAddressCode

public static String getAddressCode(String cardNumber)

获取地址编码

参数:

cardNumber - 身份证号

返回:

String

getBirthDate

public static Date getBirthDate(String cardNumber)

获取出生日期

参数:

cardNumber - 身份证号

返回:

Date

isMale

public static boolean isMale(String cardNumber)

男

参数:

cardNumber - 身份证号

返回:

boolean

isFemale

public static boolean isFemale(String cardNumber)

女

参数:

cardNumber - 身份证号

返回:

boolean

getGenderCode

public static int getGenderCode(String cardNumber)

获取身份证的第17位，奇数为男性，偶数为女性

参数:

cardNumber - 身份证号

返回:

int

getBirthDayPart

public static String getBirthDayPart(String cardNumber)

获取出生日期字符串

参数:

cardNumber - 身份证号

返回:

String

createBirthDateParser

public static SimpleDateFormat createBirthDateParser()

格式化出生日期

返回:

SimpleDateFormat

calculateVerifyCode

public static char calculateVerifyCode(CharSequence cardNumber)

校验码（第十八位数）：

• 十七位数字本体码加权求和公式 S = Sum(Ai * Wi), i = 0...16 ，先对前17位数字的权求和； Ai:表示第i位置上的身份证号码数字值 Wi:表示第i位置上的加权因子 Wi: 7 9 10 5 8 4 2 1 6 3 7 9 10 5 8 4 2；
• 计算模 Y = mod(S, 11)
• 通过模得到对应的校验码 Y: 0 1 2 3 4 5 6 7 8 9 10 校验码: 1 0 X 9 8 7 6 5 4 3 2

参数:

cardNumber - 身份证号码

返回:

char

convertToNewCardNumber

public static String convertToNewCardNumber(String cardNumber)

把15位身份证号码转换到18位身份证号码
15位身份证号码与18位身份证号码的区别为：
1、15位身份证号码中，"出生年份"字段是2位，转换时需要补入"19"，表示20世纪
2、15位身份证无最后一位校验码。18位身份证中，校验码根据根据前17位生成

参数:

cardNumber - 身份证号码

返回:

String

getAgeFromBirthTime

public static int getAgeFromBirthTime(Date birthDate)

根据年月日计算年龄

参数:

birthDate - 日期

返回:

int

getAgeFromBirthTime

public static int getAgeFromBirthTime(long birthTimeLong)

根据时间戳计算年龄

参数:

birthTimeLong - 时间戳

返回:

int