Struct DateTime 

pub struct DateTime(pub OffsetDateTime);

An RFC 3339 date-time, the wire form of OpenAPI’s format: date-time.

Tuple Fields

0: OffsetDateTime

Implementations

impl DateTime

pub fn into_inner(self) -> OffsetDateTime

The wrapped time value.

impl DateTime

pub fn parse_strict(text: &str) -> Result<Self, ParseError>

Parse an RFC 3339 date-time exactly: YYYY-MM-DDTHH:MM:SS[.fraction](Z|±HH:MM), with an upper-case T and Z, a year from 0001, a real calendar day and no leap second.

pub fn parse_lenient(text: &str) -> Result<Self, ParseError>

As parse_strict, but seconds may be omitted (HH:MM), T and Z may be lower case (RFC 3339 §5.6) and the year may be 0000: every value a contract with a date-time format or its own pattern may carry.

impl DateTime

pub fn to_millis_string(&self) -> String

RFC 3339 with exactly three fractional digits (2024-01-01T00:00:00.000Z): the form a date-time takes where the contract’s pattern requires milliseconds.

Methods from Deref<Target = OffsetDateTime>

pub const UNIX_EPOCH: OffsetDateTime

Trait Implementations

impl Clone for DateTime

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DateTime

impl Debug for DateTime

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

Formats the value using the given formatter.

impl Deref for DateTime

type Target = OffsetDateTime

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for DateTime

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'de> Deserialize<'de> for DateTime

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

Lenient (see DateTime::parse_lenient), so no value the contract allows is refused.

impl Display for DateTime

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

The RFC 3339 rendering — the same bytes Serialize writes.

This matters beyond convenience: a multipart/form-data text part and a text/plain body are rendered through Display, so a Display that disagreed with Serialize would put two different encodings of the same value on the wire depending on the body’s media type.

RFC 3339 fixes the year at four digits, so a year outside 0..=9999 — which time can hold but RFC 3339 cannot express — has no rendering here. It falls back to time’s own form rather than failing, because Display failure would panic through to_string() at exactly those two call sites. Serialize still refuses such a value, so it can never reach a JSON body claiming to be RFC 3339.

impl Eq for DateTime

impl From<DateTime> for OffsetDateTime

fn from(value: DateTime) -> Self

Converts to this type from the input type.

impl From<OffsetDateTime> for DateTime

fn from(value: OffsetDateTime) -> Self

Converts to this type from the input type.

impl FromStr for DateTime

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

Strict RFC 3339 (see DateTime::parse_strict).

type Err = ParseError

The associated error which can be returned from parsing.

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

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

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

Restrict a value to a certain range.

impl PartialEq for DateTime

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

Equality operator ==.

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

Inequality operator !=.

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: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DateTime