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][generaliedtime].

Features

This struct is enabled by chrono feature.

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

Examples

use yasna::models::UTCTime;
use chrono::{Datelike,Timelike};
let datetime = *UTCTime::parse(b"8201021200Z").unwrap().datetime();
assert_eq!(datetime.year(), 1982);
assert_eq!(datetime.month(), 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<Tz: TimeZone>(datetime: &DateTime<Tz>) -> Self

Constructs UTCTime from a datetime.

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<Tz: TimeZone>(datetime: &DateTime<Tz>) -> Option<Self>

Constructs UTCTime from a datetime.

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) -> &DateTime<Utc>

Returns the datetime 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.

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

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.

const fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

const fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

const fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<UTCTime> for UTCTime

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

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

const 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<UTCTime> for UTCTime

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

This method returns an ordering between self and other values if one exists.

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

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

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

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

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

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

const 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 StructuralEq for UTCTime

impl StructuralPartialEq for UTCTime