Struct idcard::Identity

pub struct Identity { /* fields omitted */ }

An object representation of the Chinese ID.

Implementations

impl Identity

pub fn new(number: &str) -> Self

Creates an identity object from given number.

pub fn number(&self) -> String

Returns the ID number.

pub fn birth_date(&self) -> Option<String>

Returns the date of birth(yyyy-mm-dd).

pub fn year(&self) -> Option<i32>

Returns the year of birth.

pub fn month(&self) -> Option<i32>

Returns the month of birth.

pub fn date(&self) -> Option<i32>

Returns the day in the month of the birth.

pub fn age(&self) -> Option<u32>

Calculates the current age based on the computer’s local date, if the birth year is less than the local’s, it returns None.

pub fn age_in_year(&self, year: u32) -> Option<u32>

Calculates the age based on the given year, if the given year is less than the birth year, it returns None.

pub fn gender(&self) -> Option<Gender>

Returns the gender.

pub fn province(&self) -> Option<String>

Returns the province name based on the first 2 digits of the number

pub fn region(&self) -> Option<String>

Returns the region name based on the first 6 digits of the number

pub fn constellation(&self) -> Option<String>

Returns the constellation by the date of birth.

pub fn chinese_era(&self) -> Option<String>

Returns the Chinese Era by the year of birth.

pub fn chinese_zodiac(&self) -> Option<String>

Returns the Chinese Zodiac animal by the year of birth.

pub fn is_valid(&self) -> bool

Checks if the number is valid.

pub fn is_empty(&self) -> bool

Checks if the number is empty.

pub fn len(&self) -> usize

Returns the length of the number.

Trait Implementations

impl Debug for Identity

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq<Identity> for Identity

fn eq(&self, other: &Identity) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Identity) -> bool

This method tests for !=.

impl PartialOrd<Identity> for Identity

fn partial_cmp(&self, other: &Identity) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

pub fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

pub fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

pub fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

pub fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Identity