pub struct UtcTime(/* private fields */);
Available on crate feature pkcs8 only.
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§

§

impl UtcTime

pub const LENGTH: usize = 13usize

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

pub const MAX_YEAR: u16 = 2_049u16

Maximum year that can be represented as a UTCTime.

pub fn from_date_time(datetime: DateTime) -> Result<UtcTime, Error>

Create a UtcTime from a DateTime.

pub fn to_date_time(&self) -> DateTime

Convert this UtcTime into a DateTime.

pub fn from_unix_duration(unix_duration: Duration) -> Result<UtcTime, Error>

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

pub fn to_unix_duration(&self) -> Duration

Get the duration of this timestamp since UNIX_EPOCH.

pub fn from_system_time(time: SystemTime) -> Result<UtcTime, Error>

Available on crate feature std only.

Instantiate from SystemTime.

pub fn to_system_time(&self) -> SystemTime

Available on crate feature std only.

Convert to SystemTime.

Trait Implementations§

§

impl Clone for UtcTime

§

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
§

impl Debug for UtcTime

§

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

Formats the value using the given formatter. Read more
§

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

§

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

Attempt to decode this message using the provided Reader.
§

impl EncodeValue for UtcTime

§

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

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<(), Error>

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

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

Get the Header used to encode this value.
§

impl FixedTag for UtcTime

§

const TAG: Tag = Tag::UtcTime

ASN.1 tag
§

impl From<&UtcTime> for DateTime

§

fn from(utc_time: &UtcTime) -> DateTime

Converts to this type from the input type.
§

impl From<&UtcTime> for UtcTime

§

fn from(value: &UtcTime) -> UtcTime

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 Ord for UtcTime

§

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
§

impl PartialEq for UtcTime

§

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

impl PartialOrd for UtcTime

§

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
§

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

Available on crate feature alloc only.
§

type Error = Error

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

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

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<UtcTime, Error>

Performs the conversion.
§

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

§

type Error = Error

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

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

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<UtcTime, Error>

Performs the conversion.
§

impl Copy for UtcTime

§

impl Eq for UtcTime

§

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
§

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<'a, T> Decode<'a> for T
where T: DecodeValue<'a> + FixedTag,

§

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

Attempt to decode this message using the provided decoder.
§

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

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

impl<T> DerOrd for T

§

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

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

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

§

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

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

§

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

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

§

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

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

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

Available on crate feature alloc only.
Encode this message as ASN.1 DER, appending it to the provided byte vector.
§

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

Available on crate feature alloc only.
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> Same for T

§

type Output = T

Should always be Self
§

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

§

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

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

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