Struct Datetime 

pub struct Datetime {
    pub date: Option<Date>,
    pub time: Option<Time>,
    pub offset: Option<Offset>,
}

Re-exported from deser::ext for convenience. A date, a time of the day, or both with an optional offset.

This is a well-known extension type (see ext) for the date and time values of RFC 3339:

Kind	date	time	offset
offset date-time (1979-05-27T07:32:00Z)	Some	Some	Some
local date-time (1979-05-27T07:32:00)	Some	Some	None
local date (1979-05-27)	Some	None	None
local time (07:32:00)	None	Some	None

The fallback is the RFC 3339 representation as string.

Parsing is lenient: the separator between date and time can be T, t or a space, Z can be lowercase and seconds can be omitted. Formatting always produces RFC 3339. Digits of the fraction beyond nanoseconds are truncated.

use deser::ext::Datetime;

let dt: Datetime = "1979-05-27 07:32:00.5-07:00".parse().unwrap();
assert_eq!(dt.to_string(), "1979-05-27T07:32:00.5-07:00");

With the jiff, chrono and time features the date and time types of these crates serialize as Datetime (or Timestamp).

Fields

date: Option<Date>

The date. None for local times.

time: Option<Time>

The time. None for local dates.

offset: Option<Offset>

The offset. Only set for offset date-times.

Implementations

impl Datetime

pub fn is_valid(&self) -> bool

Returns true if the value is a valid date-time.

The fields are public, so a Datetime can be constructed that is invalid (for instance an offset without date and time or February 30th).

pub fn kind(&self) -> &'static str

Returns a human readable name for the kind of date-time.

This is one of "offset date-time", "local date-time", "local date" and "local time".

Trait Implementations

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

impl Debug for Datetime

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

Formats the value using the given formatter.

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

fn deserialize_atom( slot: &mut Slot<Datetime>, atom: Atom<'_>, state: &mut State, ) -> Result<(), Error>

Deserializes an atom into the slot.

fn expecting() -> Cow<'static, str>

Returns what the value expects, for error messages.

fn deserialize_into<'out>( out: &'out mut Option<T>, state: &mut State, ) -> SinkHandle<'out, 'de>

Creates a sink that deserializes the value into the given slot.

fn deserialize_borrowed_atom( slot: &mut Slot<T, Self>, atom: Atom<'de>, state: &mut State, ) -> Result<(), Error>

Deserializes an atom that borrows from the data being deserialized into the slot.

fn describe_type(d: &mut dyn Describe)

Describes the Rust shape of the type.

fn initial_value() -> Option<T>

Provides the value of a missing struct field.

fn deserialize_update<'out>( value: &'out mut T, state: &mut State, ) -> SinkHandle<'out, 'de>

Creates a sink that updates an existing value.

impl Display for Datetime

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

Formats the value using the given formatter.

impl Eq for Datetime

impl Extension for Datetime

fn name(&self) -> &str

Returns the human readable name of the extension type.

fn fallback(&self) -> Atom<'_>

Lowers the value into the core data model.

impl From<Date> for Datetime

fn from(date: Date) -> Datetime

Converts to this type from the input type.

impl From<Time> for Datetime

fn from(time: Time) -> Datetime

Converts to this type from the input type.

impl FromStr for Datetime

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Datetime, Error>

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

impl Hash for Datetime

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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 Datetime

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Datetime

fn serialize<'a>( value: &'a Datetime, _state: &mut State, ) -> Result<Emit<'a>, Error>

Serializes the value.

fn finish(value: &T, state: &mut State) -> Result<(), Error>

Invoked after the serialization finished.

fn is_optional(value: &T) -> bool

Checks if the value represents an optional value.

fn describe(value: &T, d: &mut dyn Describe)

Describes the Rust shape of the value.

fn container_shape(value: &T) -> ContainerShape

Returns the shape of the value if it’s a map or sequence.

impl StructuralPartialEq for Datetime

impl TryFrom<Timestamp> for Datetime

fn try_from(value: Timestamp) -> Result<Datetime, Error>

Converts a timestamp into an offset date-time in UTC.

type Error = Error

The type returned in the event of a conversion error.