Skip to main content

UtcTime

Struct UtcTime

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§

impl UtcTime

pub const LENGTH: usize = 13

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

pub const MAX_YEAR: u16 = 2049

Maximum year that can be represented as a UTCTime.

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

Create a UtcTime from a DateTime.

§Errors

Returns Error in the event datetime has a year that exceeds UtcTime::MAX_YEAR.

pub fn to_date_time(&self) -> DateTime

Convert this UtcTime into a DateTime.

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”)

§Errors

If DateTime couldn’t be created from unix_duration successfully.

pub fn to_unix_duration(&self) -> Duration

Get the duration of this timestamp since UNIX_EPOCH.

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 UtcTime

fn clone(&self) -> UtcTime

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 UtcTime

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

Formats the value using the given formatter. Read more

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

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

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 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 From<UtcTime> for SystemTime

Available on crate feature std only.

fn from(utc_time: UtcTime) -> SystemTime

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 (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 UtcTime

fn eq(&self, other: &UtcTime) -> 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 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 (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<'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>

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<'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>

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

impl Eq for UtcTime

impl StructuralPartialEq for UtcTime

Auto Trait Implementations§

impl Freeze for UtcTime

impl RefUnwindSafe for UtcTime

impl Send for UtcTime

impl Sync for UtcTime

impl Unpin for UtcTime

impl UnsafeUnpin for UtcTime

impl UnwindSafe for UtcTime

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