Struct yasna::models::GeneralizedTime

pub struct GeneralizedTime { /* private fields */ }

Date and time between 0000-01-01T00:00:00Z and 9999-12-31T23:59:60.999…Z.

It can contain arbitrary length of decimal fractional seconds. However, it doesn’t carry accuracy information. It can also contain leap seconds.

The datetime is canonicalized to UTC. It doesn’t carry timezone information.

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

Features

This struct is enabled by time feature.

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

Examples

use yasna::models::GeneralizedTime;
let datetime =
    *GeneralizedTime::parse(b"19851106210627.3Z").unwrap().datetime();
assert_eq!(datetime.year(), 1985);
assert_eq!(datetime.month() as u8, 11);
assert_eq!(datetime.day(), 6);
assert_eq!(datetime.hour(), 21);
assert_eq!(datetime.minute(), 6);
assert_eq!(datetime.second(), 27);
assert_eq!(datetime.nanosecond(), 300_000_000);

Implementations

impl GeneralizedTime

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

Parses ASN.1 string representation of GeneralizedTime.

Examples

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

Errors

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

pub fn parse_with_offset(buf: &[u8], default_offset: UtcOffset) -> Option<Self>

Parses ASN.1 string representation of GeneralizedTime, with the default timezone for local time given.

Examples

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

Errors

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

pub fn from_datetime(datetime: OffsetDateTime) -> Self

Constructs GeneralizedTime from an OffsetDateTime.

Panics

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

• The year is not between 0 and 9999.

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

Constructs GeneralizedTime from an OffsetDateTime.

Errors

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

• The year is not between 0 and 9999.

pub fn from_datetime_and_sub_nano( datetime: OffsetDateTime, sub_nano: &[u8], ) -> Self

Constructs GeneralizedTime from an OffsetDateTime and sub-nanoseconds digits.

Panics

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

• The year is not between 0 and 9999.

It also panics if sub_nano contains a non-digit character.

pub fn from_datetime_and_sub_nano_opt( datetime: OffsetDateTime, sub_nano: &[u8], ) -> Option<Self>

Constructs GeneralizedTime from an OffsetDateTime and sub-nanoseconds digits.

Errors

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

• The year is not between 0 and 9999.

It also returns None if sub_nano contains a non-digit character.

pub fn datetime(&self) -> &OffsetDateTime

Returns the OffsetDateTime it represents.

Leap seconds and sub-nanoseconds digits will be discarded.

pub fn sub_nano(&self) -> &[u8]

Returns sub-nanoseconds digits of the datetime.

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 GeneralizedTime

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

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

impl Clone for GeneralizedTime

fn clone(&self) -> GeneralizedTime

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DEREncodable for GeneralizedTime

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

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

impl Debug for GeneralizedTime

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

Formats the value using the given formatter.

impl Hash for GeneralizedTime

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 GeneralizedTime

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

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

fn partial_cmp(&self, other: &GeneralizedTime) -> 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 GeneralizedTime

impl StructuralPartialEq for GeneralizedTime