Struct yasna::models::GeneralizedTime

pub struct GeneralizedTime { /* fields omitted */ }

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 chrono feature.

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

Examples

use yasna::models::GeneralizedTime;
use chrono::{Datelike,Timelike};
let datetime =
    *GeneralizedTime::parse(b"19851106210627.3Z").unwrap().datetime();
assert_eq!(datetime.year(), 1985);
assert_eq!(datetime.month(), 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);

Methods

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_timezone<Tz: TimeZone>(
    buf: &[u8],
    default_tz: &Tz
) -> 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<Tz: TimeZone>(datetime: &DateTime<Tz>) -> Self

Constructs GeneralizedTime from a datetime.

Panics

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

• The year is not between 0 and 9999.

pub fn from_datetime_opt<Tz: TimeZone>(datetime: &DateTime<Tz>) -> Option<Self>

Constructs GeneralizedTime from a datetime.

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<Tz: TimeZone>(
    datetime: &DateTime<Tz>,
    sub_nano: &[u8]
) -> Self

Constructs GeneralizedTime from a datetime 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<Tz: TimeZone>(
    datetime: &DateTime<Tz>,
    sub_nano: &[u8]
) -> Option<Self>

Constructs GeneralizedTime from a datetime 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) -> &DateTime<Utc>

Returns the datetime it represents, discarding sub-nanoseconds digits.

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 DEREncodable for GeneralizedTime

fn encode_der(&self, writer: DERWriter)

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

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 Eq for GeneralizedTime

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<GeneralizedTime> 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: &GeneralizedTime) -> bool

This method tests for !=.

impl PartialOrd<GeneralizedTime> 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: &GeneralizedTime) -> bool

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

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

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

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

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

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

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

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, 

Feeds a slice of this type into the given [Hasher].