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) -> &str

Returns the ID number.

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

Returns the formatted 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 day(&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<&str>

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

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

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

pub fn region_code(&self) -> Option<&str>

Returns the region code(the first 6 digits)

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

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<&str>

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.

pub fn to_json_string(&self, pretty: bool) -> String

Converts the value to a JSON string.

Trait Implementations

impl Clone for Identity

fn clone(&self) -> Identity

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Identity

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

Formats the value using the given formatter.

impl Ord for Identity

fn cmp(&self, other: &Identity) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

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]

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

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

#[must_use]

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]

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

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

#[must_use]

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 Eq for Identity

impl StructuralEq for Identity

impl StructuralPartialEq for Identity