Struct DateTime

pub struct DateTime { /* private fields */ }

A representation of a date and time.

Implementations

impl DateTime

pub const fn ymd(year: i16, month: u8, day: u8) -> DateTimeBuilder

Create a new date and time object.

pub const fn from_timestamp(timestamp: i64, nanos: u32) -> Self

Create a new date and time object from the given Unix timestamp.

pub const fn from_timestamp_millis(millis: i64) -> Self

Create a new date and time object from the given Unix timestamp in milliseconds.

pub const fn from_timestamp_micros(micros: i64) -> Self

Create a new date and time object from the given Unix timestamp in microseconds.

pub const fn from_timestamp_nanos(nanos: i128) -> Self

Create a new date and time object from the given Unix timestamp in nanoseconds.

pub fn now() -> Self

Return the current timestamp.

Panic

Panics if the system clock is set prior to January 1, 1970.

impl DateTime

Accessors

pub const fn year(&self) -> i16

The year for this date.

pub const fn month(&self) -> u8

The month for this date.

pub const fn day(&self) -> u8

The day of the month for this date.

pub const fn weekday(&self) -> Weekday

The day of the week for this date.

pub const fn hour(&self) -> u8

The hour of the day for this date and time. Range: [0, 24)

pub const fn minute(&self) -> u8

The minute of the hour for this date and time. Range: [0, 60)

pub const fn second(&self) -> u8

The second of the minute for this date and time. Range: [0, 60)

pub const fn nanosecond(&self) -> u32

The nanosecond of the second for this date and time. Range: [0, 1_000_000_000)

pub const fn day_of_year(&self) -> u16

The ordinal day of the year.

pub const fn date(&self) -> Date

The date corresponding to this datetime.

pub const fn as_seconds(&self) -> i64

The number of seconds since the Unix epoch for this date and time.

pub const fn as_milliseconds(&self) -> i64

The number of milliseconds since the Unix epoch for this date and time.

pub const fn as_microseconds(&self) -> i64

The number of microseconds since the Unix epoch for this date and time.

pub const fn as_nanoseconds(&self) -> i128

The number of nanoseconds since the Unix epoch for this date and time.

pub const fn precision(&self) -> Precision

The precision required to represent this timestamp with no fidelity loss.

impl DateTime

pub fn format(&self, format: &'static str) -> FormattedDateTime<'_>

Format the given date and time according to the provided strftime-like string.

impl DateTime

pub fn parse( datetime_str: impl AsRef<str>, fmt: &'static str, ) -> ParseResult<Self>

Parse a date from a string, according to the provided format string.

Trait Implementations

impl Add<TimeInterval> for DateTime

type Output = DateTime

The resulting type after applying the + operator.

fn add(self, rhs: TimeInterval) -> Self::Output

Performs the + operation.

impl AddAssign<TimeInterval> for DateTime

fn add_assign(&mut self, rhs: TimeInterval)

Performs the += operation.

impl Clone for DateTime

fn clone(&self) -> DateTime

Returns a duplicate of the value.

const 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<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl FromStr for DateTime

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> ParseResult<Self>

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

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

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

Serialize this value into the given Serde serializer.

impl Sub<TimeInterval> for DateTime

type Output = DateTime

The resulting type after applying the - operator.

fn sub(self, rhs: TimeInterval) -> Self::Output

Performs the - operation.

impl Sub for DateTime

type Output = TimeInterval

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl SubAssign<TimeInterval> for DateTime

fn sub_assign(&mut self, rhs: TimeInterval)

Performs the -= operation.

impl TryFrom<RawDateTime> for DateTime

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from(value: RawDateTime) -> ParseResult<Self>

Performs the conversion.

impl Copy for DateTime

impl Eq for DateTime