Struct der::asn1::UtcTime

source ·
pub struct UtcTime(/* private fields */);
Expand description

ASN.1 UTCTime type.

This type implements the validity requirements specified in RFC 5280 Section 4.1.2.5.1, namely:

For the purposes of this profile, UTCTime values MUST be expressed in Greenwich Mean Time (Zulu) and MUST include seconds (i.e., times are YYMMDDHHMMSSZ), even where the number of seconds is zero. Conforming systems MUST interpret the year field (YY) as follows:

  • Where YY is greater than or equal to 50, the year SHALL be interpreted as 19YY; and
  • Where YY is less than 50, the year SHALL be interpreted as 20YY.

Note: Due to common operations working on UNIX_EPOCH UtcTimes are only supported for the years 1970-2049.

Implementations§

source§

impl UtcTime

source

pub const LENGTH: usize = 13usize

Length of an RFC 5280-flavored ASN.1 DER-encoded UtcTime.

source

pub const MAX_YEAR: u16 = 2_049u16

Maximum year that can be represented as a UTCTime.

source

pub fn from_date_time(datetime: DateTime) -> Result<Self>

Create a UtcTime from a DateTime.

source

pub fn to_date_time(&self) -> DateTime

Convert this UtcTime into a DateTime.

source

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

Create a new UtcTime given a Duration since UNIX_EPOCH (a.k.a. “Unix time”)

source

pub fn to_unix_duration(&self) -> Duration

Get the duration of this timestamp since UNIX_EPOCH.

source

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

Instantiate from SystemTime.

source

pub fn to_system_time(&self) -> SystemTime

Convert to SystemTime.

Trait Implementations§

source§

impl Clone for UtcTime

source§

fn clone(&self) -> UtcTime

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for UtcTime

source§

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

Formats the value using the given formatter. Read more
source§

impl<'a> DecodeValue<'a> for UtcTime

source§

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

Attempt to decode this message using the provided Reader.
source§

impl EncodeValue for UtcTime

source§

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

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

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

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

fn header(&self) -> Result<Header>
where Self: Tagged,

Get the Header used to encode this value.
source§

impl FixedTag for UtcTime

source§

const TAG: Tag = Tag::UtcTime

ASN.1 tag
source§

impl From<&UtcTime> for DateTime

source§

fn from(utc_time: &UtcTime) -> DateTime

Converts to this type from the input type.
source§

impl From<&UtcTime> for UtcTime

source§

fn from(value: &UtcTime) -> UtcTime

Converts to this type from the input type.
source§

impl From<UtcTime> for DateTime

source§

fn from(utc_time: UtcTime) -> DateTime

Converts to this type from the input type.
source§

impl From<UtcTime> for SystemTime

source§

fn from(utc_time: UtcTime) -> SystemTime

Converts to this type from the input type.
source§

impl Ord for UtcTime

source§

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

This method returns an Ordering between self and other. Read more
1.21.0 · source§

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

Compares and returns the maximum of two values. Read more
1.21.0 · source§

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

Compares and returns the minimum of two values. Read more
1.50.0 · source§

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

Restrict a value to a certain interval. Read more
source§

impl PartialEq for UtcTime

source§

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl PartialOrd for UtcTime

source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

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

This method tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

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

This method tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

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

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

impl<'__der> TryFrom<&'__der Any> for UtcTime

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: &'__der Any) -> Result<UtcTime>

Performs the conversion.
source§

impl TryFrom<&DateTime> for UtcTime

§

type Error = Error

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for UtcTime

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<UtcTime>

Performs the conversion.
source§

impl TryFrom<DateTime> for UtcTime

§

type Error = Error

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl Copy for UtcTime

source§

impl Eq for UtcTime

source§

impl StructuralPartialEq for UtcTime

Auto Trait Implementations§

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
source§

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

source§

fn can_decode(tag: Tag) -> bool

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

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

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

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

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

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

source§

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

Attempt to decode this message using the provided decoder.
source§

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

Parse Self from the provided DER-encoded byte slice.
source§

impl<T> DerOrd for T

source§

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

Return an Ordering between self and other when serialized as ASN.1 DER.
source§

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

source§

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

Compute the length of this value in bytes when encoded as ASN.1 DER.

source§

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

Encode this value as ASN.1 DER using the provided Writer.

source§

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

Encode this value to the provided byte slice, returning a sub-slice containing the encoded message.
source§

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

Encode this message as ASN.1 DER, appending it to the provided byte vector.
source§

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

Encode this type as DER, returning a byte vector.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

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

source§

fn into(self) -> U

Calls U::from(self).

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

source§

impl<T> Tagged for T
where T: FixedTag,

source§

fn tag(&self) -> Tag

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

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

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

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

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

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

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

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

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.
source§

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

Performs the conversion.
source§

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

source§

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.
source§

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