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 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);

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_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 Clone for GeneralizedTime

fn clone(&self) -> GeneralizedTime

Returns a copy of the value.

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

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.

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

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

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

impl StructuralEq for GeneralizedTime

impl StructuralPartialEq for GeneralizedTime