Struct ParseDate 

pub struct ParseDate(/* private fields */);

A Parse date. Millisecond precision, UTC.

Precision is truncated to milliseconds on construction rather than at serialization, so that two values that will serialize identically also compare equal. Doing it the other way round makes a == b disagree with encode(a) == encode(b), which is the kind of thing that produces an intermittent conformance failure.

Implementations

impl ParseDate

pub fn from_datetime(dt: DateTime<Utc>) -> Self

Truncates sub-millisecond precision.

Total by construction. The millisecond count came from a DateTime, so reconstructing one from it cannot fail, but this is a request path and “cannot fail” is not a reason to write a panic. Falling back to the untruncated value degrades precision on a date no client can construct, which is a strictly better failure than taking down a worker.

pub fn now() -> Self

pub fn timestamp_millis(&self) -> i64

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

pub fn to_iso(&self) -> String

The ISO form Parse emits: exactly three fractional digits, Z, never +00:00.

pub fn parse_iso(s: &str) -> Result<Self, ParseError>

Parse an ISO 8601 string.

Deliberately permissive on input and strict on output, which matches Node: new Date(s) accepts offsets and varying fractional precision, and toISOString() always emits millisecond Z. So a value read from a database written by another client may carry an offset, and it must normalize rather than fail.

Trait Implementations

impl Clone for ParseDate

fn clone(&self) -> ParseDate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ParseDate

impl Debug for ParseDate

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

Formats the value using the given formatter.

impl Eq for ParseDate

impl Hash for ParseDate

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 ParseDate

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

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ParseDate

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