Struct proof_of_sql_parser::posql_time::PoSQLTimestamp

pub struct PoSQLTimestamp { /* private fields */ }

Defines an RFC3339-formatted timestamp Represents a fully parsed timestamp with detailed time unit and timezone information

Implementations

impl PoSQLTimestamp

pub fn timestamp(&self) -> DateTime<Utc>

Returns the combined date and time with time zone.

pub fn timeunit(&self) -> PoSQLTimeUnit

Returns the PoSQLTimeUnit for this timestamp

pub fn timezone(&self) -> PoSQLTimeZone

Returns the PoSQLTimeZone for this timestamp

pub fn try_from(timestamp_str: &str) -> Result<Self, PoSQLTimestampError>

Attempts to parse a timestamp string into an PoSQLTimestamp structure. This function supports two primary formats:

1. RFC 3339 Parsing:

   • Parses the timestamp along with its timezone.
   • If parsing succeeds, it extracts the timezone offset using dt.offset().local_minus_utc() and then uses this to construct the appropriate PoSQLTimeZone.

2. Timezone Parsing and Conversion:

   • The from_offset method is used to determine whether the timezone should be represented as Utc or FixedOffset. This function simplifies the decision based on the offset value.

Examples

use chrono::{DateTime, Utc};
use proof_of_sql_parser::posql_time::{PoSQLTimestamp, PoSQLTimeZone};

// Parsing an RFC 3339 timestamp without a timezone:
let timestamp_str = "2009-01-03T18:15:05Z";
let intermediate_timestamp = PoSQLTimestamp::try_from(timestamp_str).unwrap();
assert_eq!(intermediate_timestamp.timezone(), PoSQLTimeZone::Utc);

// Parsing an RFC 3339 timestamp with a positive timezone offset:
let timestamp_str_with_tz = "2009-01-03T18:15:05+03:00";
let intermediate_timestamp = PoSQLTimestamp::try_from(timestamp_str_with_tz).unwrap();
assert_eq!(intermediate_timestamp.timezone(), PoSQLTimeZone::FixedOffset(10800)); // 3 hours in seconds

pub fn to_timestamp(epoch: i64) -> Result<Self, PoSQLTimestampError>

Attempts to parse a timestamp string into an PoSQLTimestamp structure. This function supports two primary formats:

Unix Epoch Time Parsing:

• Since Unix epoch timestamps don’t inherently carry timezone information, any Unix time parsed directly from an integer is assumed to be in UTC.

Examples

use chrono::{DateTime, Utc};
use proof_of_sql_parser::posql_time::{PoSQLTimestamp, PoSQLTimeZone};

// Parsing a Unix epoch timestamp (assumed to be seconds and UTC):
let unix_time = 1231006505;
let intermediate_timestamp = PoSQLTimestamp::to_timestamp(unix_time).unwrap();
assert_eq!(intermediate_timestamp.timezone(), PoSQLTimeZone::Utc);

Trait Implementations

impl Clone for PoSQLTimestamp

fn clone(&self) -> PoSQLTimestamp

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PoSQLTimestamp

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PoSQLTimestamp

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<PoSQLTimestamp> for Literal

fn from(time: PoSQLTimestamp) -> Self

Converts to this type from the input type.

impl Hash for PoSQLTimestamp

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 PartialEq for PoSQLTimestamp

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PoSQLTimestamp

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PoSQLTimestamp

impl StructuralPartialEq for PoSQLTimestamp