Struct yasna::models::UTCTime

pub struct UTCTime { /* private fields */ }

Date and time between 1950-01-01T00:00:00Z and 2049-12-31T23:59:59Z. It cannot express fractional seconds and leap seconds. It doesn’t carry timezone information.

Corresponds to ASN.1 UTCTime type. Often used in conjunction with GeneralizedTime.

Features

This struct is enabled by time feature.

[dependencies]
yasna = { version = "*", features = ["time"] }

Examples

use yasna::models::UTCTime;
let datetime = *UTCTime::parse(b"8201021200Z").unwrap().datetime();
assert_eq!(datetime.year(), 1982);
assert_eq!(datetime.month() as u8, 1);
assert_eq!(datetime.day(), 2);
assert_eq!(datetime.hour(), 12);
assert_eq!(datetime.minute(), 0);
assert_eq!(datetime.second(), 0);
assert_eq!(datetime.nanosecond(), 0);

Implementations

impl UTCTime

pub fn parse(buf: &[u8]) -> Option<Self>

Parses ASN.1 string representation of UTCTime.

Examples

use yasna::models::UTCTime;
let datetime = UTCTime::parse(b"000229123456Z").unwrap();
assert_eq!(&datetime.to_string(), "000229123456Z");

Errors

It returns None if the given string does not specify a correct datetime.

Interpretation

While neither X.680 nor X.690 specify interpretation of 2-digits year, X.501 specifies that UTCTime in Time shall be interpreted as between 1950 and 2049. This method parses the string according to the X.501 rule.

pub fn from_datetime(datetime: OffsetDateTime) -> Self

Constructs UTCTime from an OffsetDateTime.

Panics

Panics when UTCTime can’t represent the datetime. That is:

• The year is not between 1950 and 2049.
• It is in a leap second.
• It has a non-zero nanosecond value.

pub fn from_datetime_opt(datetime: OffsetDateTime) -> Option<Self>

Constructs UTCTime from an OffsetDateTime.

Errors

It returns None when UTCTime can’t represent the datetime. That is:

• The year is not between 1950 and 2049.
• It is in a leap second.
• It has a non-zero nanosecond value.

pub fn datetime(&self) -> &OffsetDateTime

Returns the OffsetDateTime it represents.

pub fn to_bytes(&self) -> Vec<u8>

Returns ASN.1 canonical representation of the datetime as Vec<u8>.

pub fn to_string(&self) -> String

Returns ASN.1 canonical representation of the datetime as String.

Trait Implementations

impl BERDecodable for UTCTime

fn decode_ber(reader: BERReader<'_, '_>) -> ASN1Result<Self>

Reads an ASN.1 value from BERReader and converts it to Self.

impl Clone for UTCTime

fn clone(&self) -> UTCTime

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DEREncodable for UTCTime

fn encode_der(&self, writer: DERWriter<'_>)

Writes the value as an DER-encoded ASN.1 value.

impl Debug for UTCTime

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

Formats the value using the given formatter.

impl Hash for UTCTime

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for UTCTime

fn cmp(&self, other: &UTCTime) -> 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 + PartialOrd,

Restrict a value to a certain interval.

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

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.

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Eq for UTCTime

impl StructuralPartialEq for UTCTime