Struct yasna::models::UTCTime

pub struct UTCTime { /* fields omitted */ }

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.

pub 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 Eq for UTCTime

impl Hash for UTCTime

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

Feeds this value into the given Hasher.

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

#[must_use]pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]pub fn clamp(self, min: Self, max: Self) -> 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 ==.

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

This method tests for !=.

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.

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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 StructuralEq for UTCTime

impl StructuralPartialEq for UTCTime