README.md

In CNID: Get Basic Information from Chinese ID Number

Introduction

The Chinese ID number contains a lot of information, this package helps you get the region, date of birth, age, age based on year, gender, zodiac, constellation information from the Chinese ID number.

Installation

# Install development version from GitLab
remotes::install_gitlab("chuxinyuan/cnid")
# Install from CRAN
install.packages("CNID")

Usage

Get full information from ID number.

id = c(
  "653127198503161793",
  "652801197305161555", 
  "130206202202291545",
  "110101841125178",
  "12345678",
  "65312a198204181793"
)
cnid_info(id)

Check whether the ID number is valid.

check_id(id)

Get date of birth, age, gender, etc.

birth_date(id)
age(id)
age_by_year(id)
gender(id)
region(id)
zodiac(id)
cstl(id)

Convert the 15 Digits ID Number to 18 Digits.

convert18(id)

Calculate whether a given year is a leap year. Return TRUE if it is a leap year, FALSE otherwise.

leap_year(2024)

Calculate the number of days in a given year and month, such as february 2022.

mdays(2022, 2)

Calculate the number of days in a given year, such as 2022.

ydays(2022)

License

CNID is free and open source software, licensed under MIT + file LICENSE.

CNID documentation built on April 4, 2025, 5:22 a.m.