Skip to main content

DateTime

Struct DateTime

pub struct DateTime { /* private fields */ }

Expand description

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.

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 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. Read more

1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

impl Debug for DateTime

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

Formats the value using the given formatter. Read more

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. Read more

impl Display for DateTime

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

Formats the value using the given formatter. Read more

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. Read more

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

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

Get the Header used to encode this value. Read more

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. Read more

impl Ord for DateTime

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

This method returns an Ordering between self and other. Read more

1.21.0 (const: unstable) · Source§

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

Compares and returns the maximum of two values. Read more

1.21.0 (const: unstable) · Source§

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

Compares and returns the minimum of two values. Read more

1.50.0 (const: unstable) · Source§

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

Restrict a value to a certain interval. Read more

impl PartialEq for DateTime

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

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

1.0.0 (const: unstable) · Source§

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. Read more

1.0.0 (const: unstable) · Source§

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

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

1.0.0 (const: unstable) · Source§

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

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

1.0.0 (const: unstable) · Source§

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

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

1.0.0 (const: unstable) · Source§

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

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

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 StructuralPartialEq for DateTime

Auto Trait Implementations§

impl Freeze for DateTime

impl RefUnwindSafe for DateTime

impl Send for DateTime

impl Sync for DateTime

impl Unpin for DateTime

impl UnsafeUnpin for DateTime

impl UnwindSafe for DateTime

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<'a, T> Choice<'a> for T
where T: Decode<'a> + FixedTag,

fn can_decode(tag: Tag) -> bool

Is the provided Tag decodable as a variant of this CHOICE?

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

impl<'a, T> Decode<'a> for T
where T: DecodeValue<'a> + FixedTag + 'a,

type Error = <T as DecodeValue<'a>>::Error

Type returned in the event of a decoding error.

fn decode<R>(reader: &mut R) -> Result<T, <T as DecodeValue<'a>>::Error>
where R: Reader<'a>,

Attempt to decode this TLV message using the provided decoder. Read more

fn from_der(bytes: &'a [u8]) -> Result<Self, Self::Error>

Parse Self from the provided DER-encoded byte slice. Read more

fn from_der_partial(bytes: &'a [u8]) -> Result<(Self, &'a [u8]), Self::Error>

Parse Self from the provided DER-encoded byte slice. Read more

impl<T> DerOrd for T
where T: EncodeValue + ValueOrd + Tagged,

fn der_cmp(&self, other: &T) -> Result<Ordering, Error>

Return an Ordering between self and other when serialized as ASN.1 DER. Read more

impl<T> Encode for T
where T: EncodeValue + Tagged + ?Sized,

fn encoded_len(&self) -> Result<Length, Error>

Compute the length of this TLV object in bytes when encoded as ASN.1 DER. Read more

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

Encode this TLV object as ASN.1 DER using the provided Writer. Read more

fn encode_to_slice<'a>(&self, buf: &'a mut [u8]) -> Result<&'a [u8]>

Encode this TLV object to the provided byte slice, returning a sub-slice containing the encoded message. Read more

fn encode_to_vec(&self, buf: &mut Vec<u8>) -> Result<Length>

Encode this TLV object as ASN.1 DER, appending it to the provided byte vector. Read more

fn to_der(&self) -> Result<Vec<u8>>

Encode this TLV object as ASN.1 DER, returning a byte vector. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IsConstructed for T
where T: FixedTag + ?Sized,

const CONSTRUCTED: bool = const CONSTRUCTED: bool = T::TAG.is_constructed();

ASN.1 constructed bit

impl<T> Tagged for T
where T: FixedTag + ?Sized,

fn tag(&self) -> Tag

Get the ASN.1 tag that this type is encoded with.

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> ToString for T
where T: Display + ?Sized,

fn to_string(&self) -> String

Converts the given value to a String. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T> ValueOrd for T
where T: OrdIsValueOrd,

fn value_cmp(&self, other: &T) -> Result<Ordering, Error>

Return an Ordering between value portion of TLV-encoded self and other when serialized as ASN.1 DER. Read more

impl<T> DecodeOwned for T
where T: for<'a> Decode<'a>,