Struct time::date_time::DateTime

pub struct DateTime<O: MaybeOffset> {
    pub(crate) date: Date,
    pub(crate) time: Time,
    pub(crate) offset: O::MemoryOffsetType,
}

Fields

date: Date

time: Time

offset: O::MemoryOffsetType

Implementations

impl DateTime<None>

pub const MIN: Self = _

pub const MAX: Self = _

impl DateTime<Fixed>

pub const UNIX_EPOCH: Self = _

impl<O: MaybeOffset> DateTime<O>

pub const fn new(date: Date, time: Time) -> Selfwhere O: IsOffsetKindNone,

pub const fn from_unix_timestamp(timestamp: i64) -> Result<Self, ComponentRange>where O: HasLogicalOffset,

pub const fn from_unix_timestamp_nanos( timestamp: i128 ) -> Result<Self, ComponentRange>where O: HasLogicalOffset,

pub fn now_utc() -> DateTime<Fixed>where O: IsOffsetKindFixed,

Available on crate feature std only.

pub fn now_local() -> Result<DateTime<Fixed>, IndeterminateOffset>where O: IsOffsetKindFixed,

Available on crate feature local-offset only.

pub const fn date(self) -> Date

pub const fn time(self) -> Time

pub const fn offset(self) -> UtcOffsetwhere O: HasLogicalOffset,

pub const fn year(self) -> i32

pub const fn month(self) -> Month

pub const fn day(self) -> u8

pub const fn ordinal(self) -> u16

pub const fn iso_week(self) -> u8

pub const fn sunday_based_week(self) -> u8

pub const fn monday_based_week(self) -> u8

pub const fn to_calendar_date(self) -> (i32, Month, u8)

pub const fn to_ordinal_date(self) -> (i32, u16)

pub const fn to_iso_week_date(self) -> (i32, u8, Weekday)

pub const fn weekday(self) -> Weekday

pub const fn to_julian_day(self) -> i32

pub const fn as_hms(self) -> (u8, u8, u8)

pub const fn as_hms_milli(self) -> (u8, u8, u8, u16)

pub const fn as_hms_micro(self) -> (u8, u8, u8, u32)

pub const fn as_hms_nano(self) -> (u8, u8, u8, u32)

pub const fn hour(self) -> u8

pub const fn minute(self) -> u8

pub const fn second(self) -> u8

pub const fn millisecond(self) -> u16

pub const fn microsecond(self) -> u32

pub const fn nanosecond(self) -> u32

pub const fn unix_timestamp(self) -> i64where O: HasLogicalOffset,

pub const fn unix_timestamp_nanos(self) -> i128where O: HasLogicalOffset,

pub const fn assume_offset(self, offset: UtcOffset) -> DateTime<Fixed>where O: NoLogicalOffset,

pub const fn assume_utc(self) -> DateTime<Fixed>where O: NoLogicalOffset,

pub const fn to_offset(self, offset: UtcOffset) -> DateTime<Fixed>where O: HasLogicalOffset,

pub(crate) const fn to_offset_raw(self, offset: UtcOffset) -> (i32, u16, Time)

Equivalent to .to_offset(UtcOffset::UTC), but returning the year, ordinal, and time. This avoids constructing an invalid Date if the new value is out of range.

pub const fn checked_add(self, duration: Duration) -> Option<Self>

pub const fn checked_sub(self, duration: Duration) -> Option<Self>

pub const fn saturating_add(self, duration: Duration) -> Self

pub const fn saturating_sub(self, duration: Duration) -> Self

pub const fn replace_time(self, time: Time) -> Self

pub const fn replace_date(self, date: Date) -> Self

pub const fn replace_date_time(self, date_time: DateTime<None>) -> Selfwhere O: HasLogicalOffset,

pub const fn replace_year(self, year: i32) -> Result<Self, ComponentRange>

pub const fn replace_month(self, month: Month) -> Result<Self, ComponentRange>

pub const fn replace_day(self, day: u8) -> Result<Self, ComponentRange>

pub const fn replace_hour(self, hour: u8) -> Result<Self, ComponentRange>

pub const fn replace_minute(self, minute: u8) -> Result<Self, ComponentRange>

pub const fn replace_second(self, second: u8) -> Result<Self, ComponentRange>

pub const fn replace_millisecond( self, millisecond: u16 ) -> Result<Self, ComponentRange>

pub const fn replace_microsecond( self, microsecond: u32 ) -> Result<Self, ComponentRange>

pub const fn replace_nanosecond( self, nanosecond: u32 ) -> Result<Self, ComponentRange>

pub const fn replace_offset(self, offset: UtcOffset) -> DateTime<Fixed>where O: IsOffsetKindFixed,

pub fn format_into( self, output: &mut impl Write, format: &impl Formattable + ?Sized ) -> Result<usize, Format>

Available on crate feature formatting only.

pub fn format( self, format: &impl Formattable + ?Sized ) -> Result<String, Format>

Available on crate feature formatting only.

pub fn parse( input: &str, description: &impl Parsable + ?Sized ) -> Result<Self, Parse>

Available on crate feature parsing only.

pub(crate) const fn is_valid_leap_second_stand_in(self) -> bool

Available on crate feature parsing only.

A helper method to check if the OffsetDateTime is a valid representation of a leap second. Leap seconds, when parsed, are represented as the preceding nanosecond. However, leap seconds can only occur as the last second of a month UTC.

pub const fn to_hms(self) -> (u8, u8, u8)where O: IsOffsetKindFixed,

👎Deprecated since 0.3.18: use as_hms instead

pub const fn to_hms_milli(self) -> (u8, u8, u8, u16)where O: IsOffsetKindFixed,

👎Deprecated since 0.3.18: use as_hms_milli instead

pub const fn to_hms_micro(self) -> (u8, u8, u8, u32)where O: IsOffsetKindFixed,

👎Deprecated since 0.3.18: use as_hms_micro instead

pub const fn to_hms_nano(self) -> (u8, u8, u8, u32)where O: IsOffsetKindFixed,

👎Deprecated since 0.3.18: use as_hms_nano instead

Trait Implementations

impl<O: MaybeOffset> Add<Duration> for DateTime<O>

type Output = DateTime<O>

The resulting type after applying the + operator.

fn add(self, duration: Duration) -> Self

Performs the + operation.

impl<O: MaybeOffset> Add<Duration> for DateTime<O>

type Output = DateTime<O>

The resulting type after applying the + operator.

fn add(self, duration: StdDuration) -> Self::Output

Performs the + operation.

impl<O: MaybeOffset> AddAssign<Duration> for DateTime<O>

fn add_assign(&mut self, rhs: StdDuration)

Performs the += operation.

impl<O: MaybeOffset> AddAssign<Duration> for DateTime<O>

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

impl<O: MaybeOffset + 'static> Arbitrary for DateTime<O>

Available on crate feature quickcheck only.

fn arbitrary(g: &mut Gen) -> Self

Return an arbitrary value.

fn shrink(&self) -> Box<dyn Iterator<Item = Self>>

Return an iterator of values that are smaller than itself.

impl<O: MaybeOffset> Clone for DateTime<O>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<O: MaybeOffset> Debug for DateTime<O>

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

Formats the value using the given formatter.

impl<O: MaybeOffset> Display for DateTime<O>

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

Formats the value using the given formatter.

impl<O: MaybeOffset> Eq for DateTime<O>

fn assert_receiver_is_total_eq(&self)

impl From<DateTime<Fixed>> for SystemTime

Available on crate feature std only.

fn from(datetime: DateTime<Fixed>) -> Self

Converts to this type from the input type.

impl From<SystemTime> for DateTime<Fixed>

Available on crate feature std only.

fn from(system_time: SystemTime) -> Self

Converts to this type from the input type.

impl<O: MaybeOffset> Hash for DateTime<O>

fn hash<H: Hasher>(&self, hasher: &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<O: MaybeOffset> Ord for DateTime<O>

fn cmp(&self, rhs: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<DateTime<Fixed>> for SystemTime

Available on crate feature std only.

fn eq(&self, rhs: &DateTime<Fixed>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<O: MaybeOffset> PartialEq<DateTime<O>> for DateTime<O>

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<SystemTime> for DateTime<Fixed>

Available on crate feature std only.

fn eq(&self, rhs: &SystemTime) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<DateTime<Fixed>> for SystemTime

Available on crate feature std only.

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl<O: MaybeOffset> PartialOrd<DateTime<O>> for DateTime<O>

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl PartialOrd<SystemTime> for DateTime<Fixed>

Available on crate feature std only.

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Sub<DateTime<Fixed>> for SystemTime

Available on crate feature std only.

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl<O: MaybeOffset> Sub<DateTime<O>> for DateTime<O>

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl<O: MaybeOffset> Sub<Duration> for DateTime<O>

type Output = DateTime<O>

The resulting type after applying the - operator.

fn sub(self, duration: Duration) -> Self

Performs the - operation.

impl<O: MaybeOffset> Sub<Duration> for DateTime<O>

type Output = DateTime<O>

The resulting type after applying the - operator.

fn sub(self, duration: StdDuration) -> Self::Output

Performs the - operation.

impl Sub<SystemTime> for DateTime<Fixed>

Available on crate feature std only.

type Output = Duration

The resulting type after applying the - operator.

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

Performs the - operation.

impl<O: MaybeOffset> SubAssign<Duration> for DateTime<O>

fn sub_assign(&mut self, rhs: StdDuration)

Performs the -= operation.

impl<O: MaybeOffset> SubAssign<Duration> for DateTime<O>

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl<O: MaybeOffset> TryFrom<Parsed> for DateTime<O>

Available on crate feature parsing only.

type Error = TryFromParsed

The type returned in the event of a conversion error.

fn try_from(parsed: Parsed) -> Result<Self, Self::Error>

Performs the conversion.

impl<O: MaybeOffset> Copy for DateTime<O>