Struct DateTime 

pub struct DateTime {
    year: u16,
    month: u8,
    day: u8,
    hour: u8,
    minutes: u8,
    seconds: u8,
    unix_duration: Duration,
}

Date-and-time type shared by multiple ASN.1 types (e.g. GeneralizedTime, UTCTime).

Following conventions from RFC 5280, this type is always Z-normalized (i.e. represents a UTC time). However, it isn’t named “UTC time” in order to prevent confusion with ASN.1 UTCTime.

Fields

year: u16

Full year (e.g. 2000).

Must be >=1970 to permit positive conversions to Unix time.

month: u8

Month (1-12)

day: u8

Day of the month (1-31)

hour: u8

Hour (0-23)

minutes: u8

Minutes (0-59)

seconds: u8

Seconds (0-59)

unix_duration: Duration

Duration since the Unix epoch.

Implementations

impl DateTime

pub const INFINITY: DateTime

This is the maximum date represented by the DateTime This corresponds to: 9999-12-31T23:59:59Z

pub const fn new( year: u16, month: u8, day: u8, hour: u8, minutes: u8, seconds: u8, ) -> Result<Self>

Create a new DateTime from the given UTC time components.

Errors

Returns Error with ErrorKind::DateTime in the event the date is invalid.

pub(crate) const fn from_ymd_hms( year: u16, month: u8, day: u8, hour: u8, minutes: u8, seconds: u8, ) -> Option<Self>

Create a new DateTime from the given UTC time components.

Returns None if the value is outside the supported date range.

pub fn from_unix_duration(unix_duration: Duration) -> Result<Self>

Compute a DateTime from the given Duration since the UNIX_EPOCH.

Errors

Returns error if the value is outside the supported date range.

pub fn year(&self) -> u16

Get the year.

pub fn month(&self) -> u8

Get the month.

pub fn day(&self) -> u8

Get the day.

pub fn hour(&self) -> u8

Get the hour.

pub fn minutes(&self) -> u8

Get the minutes.

pub fn seconds(&self) -> u8

Get the seconds.

pub fn unix_duration(&self) -> Duration

Compute Duration since UNIX_EPOCH from the given calendar date.

pub fn from_system_time(time: SystemTime) -> Result<Self>

Instantiate from SystemTime.

Errors

If a time conversion error occurred.

pub fn to_system_time(&self) -> SystemTime

Convert to SystemTime.

Trait Implementations

impl Clone for DateTime

fn clone(&self) -> DateTime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DateTime

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

Formats the value using the given formatter.

impl<'a> DecodeValue<'a> for DateTime

type Error = Error

Type returned in the event of a decoding error.

fn decode_value<R: Reader<'a>>(reader: &mut R, header: Header) -> Result<Self>

Attempt to decode this value using the provided Reader.

impl Display for DateTime

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

Formats the value using the given formatter.

impl EncodeValue for DateTime

fn value_len(&self) -> Result<Length>

Compute the length of this value (sans Tag+Length header) when encoded as ASN.1 DER.

fn encode_value(&self, writer: &mut impl Writer) -> Result<()>

Encode value (sans Tag+Length header) as ASN.1 DER using the provided Writer.

fn header(&self) -> Result<Header>

where Self: Tagged,

Get the Header used to encode this value.

impl FixedTag for DateTime

const TAG: Tag = Tag::GeneralizedTime

ASN.1 tag

impl From<&DateTime> for GeneralizedTime

fn from(datetime: &DateTime) -> Self

Converts to this type from the input type.

impl From<&DateTime> for SystemTime

Available on crate feature std only.

fn from(time: &DateTime) -> SystemTime

Converts to this type from the input type.

impl From<&GeneralizedTime> for DateTime

fn from(utc_time: &GeneralizedTime) -> DateTime

Converts to this type from the input type.

impl From<&UtcTime> for DateTime

fn from(utc_time: &UtcTime) -> DateTime

Converts to this type from the input type.

impl From<DateTime> for GeneralizedTime

fn from(datetime: DateTime) -> Self

Converts to this type from the input type.

impl From<DateTime> for SystemTime

Available on crate feature std only.

fn from(time: DateTime) -> SystemTime

Converts to this type from the input type.

impl From<GeneralizedTime> for DateTime

fn from(utc_time: GeneralizedTime) -> DateTime

Converts to this type from the input type.

impl From<UtcTime> for DateTime

fn from(utc_time: UtcTime) -> DateTime

Converts to this type from the input type.

impl FromStr for DateTime

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl Ord for DateTime

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for DateTime

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for DateTime

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl TryFrom<&DateTime> for UtcTime

type Error = Error

The type returned in the event of a conversion error.

fn try_from(datetime: &DateTime) -> Result<Self>

Performs the conversion.

impl TryFrom<&SystemTime> for DateTime

Available on crate feature std only.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(time: &SystemTime) -> Result<DateTime>

Performs the conversion.

impl TryFrom<DateTime> for UtcTime

type Error = Error

The type returned in the event of a conversion error.

fn try_from(datetime: DateTime) -> Result<Self>

Performs the conversion.

impl TryFrom<SystemTime> for DateTime

Available on crate feature std only.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(time: SystemTime) -> Result<DateTime>

Performs the conversion.

impl Copy for DateTime

impl Eq for DateTime

impl OrdIsValueOrd for DateTime

impl StructuralPartialEq for DateTime