Struct Datetime 

pub struct Datetime { /* private fields */ }

AT Protocol datetime (ISO 8601 with specific requirements)

Lexicon datetimes use ISO 8601 format with these requirements:

• Must include timezone (strongly prefer UTC with ‘Z’)
• Requires whole seconds precision minimum
• Supports millisecond and microsecond precision
• Uses uppercase ‘T’ to separate date and time

Examples: "1985-04-12T23:20:50.123Z", "2023-01-01T00:00:00+00:00"

The serialized form is preserved during parsing to ensure exact round-trip serialization.

Implementations

impl Datetime

pub fn now() -> Self

Returns a Datetime which corresponds to the current date and time in UTC.

The timestamp uses microsecond precision.

pub fn new(dt: DateTime<FixedOffset>) -> Self

Constructs a new Lexicon timestamp.

The timestamp is rounded to microsecond precision.

pub fn raw_str(s: impl AsRef<str>) -> Self

Infallibly parses a new Lexicon timestamp from a compatible str reference

Panics if invalid. Use the fallible trait implementations or deserialize for input you cannot reasonably trust to be properly formatted.

pub fn as_str(&self) -> &str

Extracts a string slice containing the entire Datetime.

pub fn timestamp(&self) -> i64

Extracts the number of non-leap seconds since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”).

For full access to the underlying DateTime, use the AsRef<chrono::DateTime<chrono::FixedOffset>> implementation.

pub fn timestamp_millis(&self) -> i64

Extracts the number of non-leap-milliseconds since January 1, 1970 UTC.

For full access to the underlying DateTime, use the AsRef<chrono::DateTime<chrono::FixedOffset>> implementation.

pub fn timestamp_micros(&self) -> i64

Extracts the number of non-leap-microseconds since January 1, 1970 UTC.

For full access to the underlying DateTime, use the AsRef<chrono::DateTime<chrono::FixedOffset>> implementation.

Trait Implementations

impl AsRef<DateTime<FixedOffset>> for Datetime

fn as_ref(&self) -> &DateTime<FixedOffset>

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Datetime

fn clone(&self) -> Datetime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Datetime

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Datetime

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Datetime

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

Formats the value using the given formatter.

impl Eq for Datetime

impl From<DateTime<FixedOffset>> for Datetime

fn from(dt: DateTime<FixedOffset>) -> Self

Converts to this type from the input type.

impl From<Datetime> for String

fn from(value: Datetime) -> Self

Converts to this type from the input type.

impl From<Datetime> for SmolStr

fn from(value: Datetime) -> Self

Converts to this type from the input type.

impl From<Datetime> for CowStr<'static>

fn from(value: Datetime) -> Self

Converts to this type from the input type.

impl FromStr for Datetime

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Datetime

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 IntoStatic for Datetime

type Output = Datetime

The “owned” variant of the type. For Cow<'a, str>, this is Cow<'static, str>, for example.

fn into_static(self) -> Self::Output

Turns the value into an “owned” variant, which can then be returned, moved, etc.

impl Ord for Datetime

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

Restrict a value to a certain interval.

impl PartialEq for Datetime

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

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Serialize for Datetime

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<CowStr<'_>> for Datetime

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: CowStr<'_>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for Datetime

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, Self::Error>

Performs the conversion.