The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

Type: Package
Title: Get Basic Information from Chinese ID Number
Version: 2.1.1
Maintainer: Xinyuan Chu <chuxinyuan@outlook.com>
Date: 2025-04-11 17:01:48 UTC
Description: 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.
License: MIT + file LICENSE
URL: https://github.com/chuxinyuan/cnid
BugReports: https://github.com/chuxinyuan/cnid/issues
Depends: R (≥ 3.5.0)
RoxygenNote: 7.3.2
Suggests: testthat (≥ 2.1.0)
Encoding: UTF-8
NeedsCompilation: no
Packaged: 2025-04-11 17:10:37 UTC; chuxinyuan
Author: Xinyuan Chu [aut, cre]
Repository: CRAN
Date/Publication: 2025-04-11 17:20:02 UTC

Get age information from ID number

Description

Get age information from ID number, to the day.

Usage

age(id)

Arguments

id

A vector of ID numbers.

Value

Age vector obtained from ID numbers.

Examples

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


Get age information from ID number

Description

Get age information from ID number, only by year, not the specific date.

Usage

age_by_year(id)

Arguments

id

A vector of ID numbers.

Value

Age vector obtained from ID numbers.

Examples

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


Get date of birth information from ID number

Description

Get date of birth information from ID number.

Usage

birth_date(id)

Arguments

id

A vector of ID numbers.

Value

Date of birth vector obtained from ID numbers.

Examples

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


Check whether the ID number is valid

Description

Check whether the ID number is valid.

Usage

check_id(id)

Arguments

id

A vector of ID numbers.

Value

A vector of TRUE or FALSE.

Examples

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


Get full information from ID number

Description

Get full information from ID number.

Usage

cnid_info(id)

Arguments

id

A vector of ID numbers.

Value

A data frame about date of birth, age, gender, etc. obtained from ID number.

Examples

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


Convert the 15 Digits ID Number to 18 Digits

Description

Convert the 15 Digits ID Number to 18 Digits.

Usage

convert18(id)

Arguments

id

A vector of ID numbers.

Value

The corresponding 18 digits ID number.

Examples

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


Get constellation information from ID number

Description

Get constellation information from ID number.

Usage

cstl(id)

Arguments

id

A vector of ID numbers.

Value

Constellation vector obtained from ID numbers.

Examples

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


Get gender information from ID number

Description

Get gender information from ID number.

Usage

gender(id)

Arguments

id

A vector of ID numbers.

Value

Gender vector obtained from ID numbers.

Examples

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


Calculate whether a given year is a leap year

Description

Calculate whether a given year is a leap year.

Usage

leap_year(year)

Arguments

year

A given year, vectorization parameter passing is supported.

Value

TRUE or FALSE. Return TRUE if it is a leap year, FALSE otherwise.

Examples

leap_year(2024)


Calculate the number of days in a given year and month

Description

Calculate the number of days in a given year and month.

Usage

mdays(year, month)

Arguments

year

A given year.

month

A given month, vectorization parameter passing is supported.

Value

Days in a given year and month.

Examples

mdays(2025, 1:12)


Get region information from ID number

Description

Get region information from ID number.

Usage

region(id)

Arguments

id

A vector of ID numbers.

Value

Region vector obtained from ID numbers.

Examples

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


Calculate the number of days in a given year

Description

Calculate the number of days in a given year.

Usage

ydays(year)

Arguments

year

A given year, vectorization parameter passing is supported.

Value

Days in a given year.

Examples

ydays(2025)


Get zodiac information from ID number

Description

Get zodiac information from ID number.

Usage

zodiac(id)

Arguments

id

A vector of ID numbers.

Value

Zodiac vector obtained from ID numbers.

Examples

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

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.