Struct DateTime 

#[repr(transparent)]
pub struct DateTime<U = Nanosecond>(pub i64, _)
where
    U: TimeUnitTrait;

Represents a date and time with a specific time unit precision.

Type Parameters

• U: The time unit precision, defaulting to Nanosecond. Must implement TimeUnitTrait.

Fields

• 0: An i64 representing the timestamp in the specified time unit.
• PhantomData<U>: A zero-sized type used to “mark” the time unit without affecting the struct’s memory layout.

Tuple Fields

0: i64

Implementations

impl<U> DateTime<U>

where U: TimeUnitTrait,

pub const fn new(dt: i64) -> DateTime<U>

Creates a new DateTime instance with the given timestamp.

Arguments

• dt - An i64 representing the timestamp in the specified time unit.

Returns

A new DateTime<U> instance.

pub const fn is_nat(&self) -> bool

Checks if the DateTime instance represents “Not-a-Time” (NaT).

Returns

true if the instance is NaT, false otherwise.

pub const fn is_not_nat(&self) -> bool

Checks if the DateTime instance represents a valid time (not NaT).

Returns

true if the instance is not NaT, false otherwise.

pub const fn nat() -> DateTime<U>

Creates a new DateTime instance representing “Not-a-Time” (NaT).

Returns

A new DateTime<U> instance representing NaT.

pub const fn into_i64(self) -> i64

Converts the DateTime instance to its underlying i64 timestamp.

Returns

The i64 timestamp value.

pub const fn from_opt_i64(v: Option<i64>) -> DateTime<U>

Creates a DateTime instance from an optional i64 timestamp.

Arguments

• v - An Option<i64> representing the timestamp.

Returns

A new DateTime<U> instance. If v is None, returns NaT.

pub const fn into_opt_i64(self) -> Option<i64>

Converts the DateTime instance to an optional i64 timestamp.

Returns

Some(i64) if the instance is not NaT, None otherwise.

pub fn to_cr(&self) -> Option<DateTime<Utc>>

where DateTime<U>: TryInto<DateTime<Utc>>,

👎Deprecated since 0.5.0: use as_cr instead

Converts the DateTime instance to a chrono::DateTime<Utc>.

Returns

Some(CrDateTime<Utc>) if the conversion is successful, None if the instance is NaT.

pub fn as_cr(&self) -> Option<DateTime<Utc>>

where DateTime<U>: TryInto<DateTime<Utc>>,

pub fn parse(s: &str, fmt: Option<&str>) -> Result<DateTime<U>, TError>

where DateTime<U>: From<DateTime<Utc>>,

Parses a string into a DateTime instance.

Arguments

• s - The string to parse.
• fmt - An optional format string. If None, tries multiple common formats.

Returns

A TResult<Self> containing the parsed DateTime or an error.

pub fn strftime(&self, fmt: Option<&str>) -> String

where DateTime<U>: TryInto<DateTime<Utc>>,

Formats the DateTime instance as a string.

Arguments

• fmt - An optional format string. If None, uses “%Y-%m-%d %H:%M:%S.%f”.

Returns

A formatted string representation of the DateTime.

pub fn duration_trunc(self, duration: TimeDelta) -> DateTime<U>

where DateTime<U>: TryInto<DateTime<Utc>> + From<DateTime<Utc>>,

Truncates the DateTime to a specified duration.

Arguments

• duration - A TimeDelta specifying the truncation interval.

Returns

A new DateTime<U> instance truncated to the specified duration.

impl<U> DateTime<U>

where U: TimeUnitTrait, DateTime<U>: TryInto<DateTime<Utc>>,

pub fn time(&self) -> Option<NaiveTime>

Returns the time component of the DateTime as a NaiveTime.

Returns

Option<NaiveTime>: The time component if the DateTime is valid, or None if it’s NaT.

pub fn year(&self) -> Option<i32>

Returns the year.

Returns

Option<i32>: The year if the DateTime is valid, or None if it’s NaT.

pub fn day(&self) -> Option<usize>

Returns the day of the month (1-31).

Returns

Option<usize>: The day of the month if the DateTime is valid, or None if it’s NaT.

pub fn month(&self) -> Option<usize>

Returns the month (1-12).

Returns

Option<usize>: The month if the DateTime is valid, or None if it’s NaT.

pub fn hour(&self) -> Option<usize>

Returns the hour (0-23).

Returns

Option<usize>: The hour if the DateTime is valid, or None if it’s NaT.

pub fn minute(&self) -> Option<usize>

Returns the minute (0-59).

Returns

Option<usize>: The minute if the DateTime is valid, or None if it’s NaT.

pub fn second(&self) -> Option<usize>

Returns the second (0-59).

Returns

Option<usize>: The second if the DateTime is valid, or None if it’s NaT.

impl<U> DateTime<U>

where U: TimeUnitTrait,

pub fn into_unit<T>(self) -> DateTime<T>

where T: TimeUnitTrait,

Trait Implementations

impl<U> Add<TimeDelta> for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>> + TryInto<DateTime<Utc>>,

type Output = DateTime<U>

The resulting type after applying the + operator.

fn add(self, rhs: TimeDelta) -> <DateTime<U> as Add<TimeDelta>>::Output

Performs the + operation.

impl Cast<DateTime<Microsecond>> for DateTime<Nanosecond>

fn cast(self) -> DateTime<Microsecond>

Casts the value to the target type T.

impl Cast<DateTime<Microsecond>> for DateTime<Millisecond>

fn cast(self) -> DateTime<Microsecond>

Casts the value to the target type T.

impl Cast<DateTime<Microsecond>> for DateTime<Second>

fn cast(self) -> DateTime<Microsecond>

Casts the value to the target type T.

impl Cast<DateTime<Millisecond>> for DateTime<Nanosecond>

fn cast(self) -> DateTime<Millisecond>

Casts the value to the target type T.

impl Cast<DateTime<Millisecond>> for DateTime<Microsecond>

fn cast(self) -> DateTime<Millisecond>

Casts the value to the target type T.

impl Cast<DateTime<Millisecond>> for DateTime<Second>

fn cast(self) -> DateTime<Millisecond>

Casts the value to the target type T.

impl Cast<DateTime<Second>> for DateTime<Nanosecond>

fn cast(self) -> DateTime<Second>

Casts the value to the target type T.

impl Cast<DateTime<Second>> for DateTime<Microsecond>

fn cast(self) -> DateTime<Second>

Casts the value to the target type T.

impl Cast<DateTime<Second>> for DateTime<Millisecond>

fn cast(self) -> DateTime<Second>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for &str

where DateTime<U>: From<CrDateTime<Utc>>,

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<bool>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<f32>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<f64>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<i32>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<i64>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<isize>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<u64>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<u8>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for Option<usize>

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for String

where DateTime<U>: From<CrDateTime<Utc>>,

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for TimeDelta

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for bool

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for f32

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for f64

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for i32

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for i64

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for isize

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for u64

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for u8

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<DateTime<U>> for usize

Available on crate feature time only.

fn cast(self) -> DateTime<U>

Casts the value to the target type T.

impl Cast<DateTime> for DateTime<Microsecond>

fn cast(self) -> DateTime<Nanosecond>

Casts the value to the target type T.

impl Cast<DateTime> for DateTime<Millisecond>

fn cast(self) -> DateTime<Nanosecond>

Casts the value to the target type T.

impl Cast<DateTime> for DateTime<Second>

fn cast(self) -> DateTime<Nanosecond>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<bool>> for DateTime<U>

fn cast(self) -> Option<bool>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<f32>> for DateTime<U>

fn cast(self) -> Option<f32>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<f64>> for DateTime<U>

fn cast(self) -> Option<f64>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<i32>> for DateTime<U>

fn cast(self) -> Option<i32>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<i64>> for DateTime<U>

Available on crate feature time only.

fn cast(self) -> Option<i64>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<isize>> for DateTime<U>

fn cast(self) -> Option<isize>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<u64>> for DateTime<U>

fn cast(self) -> Option<u64>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<u8>> for DateTime<U>

fn cast(self) -> Option<u8>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<Option<usize>> for DateTime<U>

fn cast(self) -> Option<usize>

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<String> for DateTime<U>

where CrDateTime<Utc>: From<DateTime<U>>,

Available on crate feature time only.

fn cast(self) -> String

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<TimeDelta> for DateTime<U>

Available on crate feature time only.

fn cast(self) -> TimeDelta

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<bool> for DateTime<U>

fn cast(self) -> bool

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<f32> for DateTime<U>

fn cast(self) -> f32

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<f64> for DateTime<U>

fn cast(self) -> f64

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<i32> for DateTime<U>

fn cast(self) -> i32

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<i64> for DateTime<U>

Available on crate feature time only.

fn cast(self) -> i64

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<isize> for DateTime<U>

fn cast(self) -> isize

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<u64> for DateTime<U>

fn cast(self) -> u64

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<u8> for DateTime<U>

fn cast(self) -> u8

Casts the value to the target type T.

impl<U: TimeUnitTrait> Cast<usize> for DateTime<U>

fn cast(self) -> usize

Casts the value to the target type T.

impl<U> Clone for DateTime<U>

where U: Clone + TimeUnitTrait,

fn clone(&self) -> DateTime<U>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<U> Debug for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: TryInto<DateTime<Utc>>,

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

Formats the value using the given formatter.

impl<U> Default for DateTime<U>

where U: TimeUnitTrait,

fn default() -> DateTime<U>

Returns the “default value” for a type.

impl From<DateTime<Utc>> for DateTime

fn from(dt: DateTime<Utc>) -> DateTime

Converts to this type from the input type.

impl From<DateTime<Utc>> for DateTime<Microsecond>

fn from(dt: DateTime<Utc>) -> DateTime<Microsecond>

Converts to this type from the input type.

impl From<DateTime<Utc>> for DateTime<Millisecond>

fn from(dt: DateTime<Utc>) -> DateTime<Millisecond>

Converts to this type from the input type.

impl From<DateTime<Utc>> for DateTime<Second>

fn from(dt: DateTime<Utc>) -> DateTime<Second>

Converts to this type from the input type.

impl<U> From<NaiveDate> for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>>,

fn from(dt: NaiveDate) -> DateTime<U>

Converts to this type from the input type.

impl<U> From<NaiveDateTime> for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>>,

fn from(dt: NaiveDateTime) -> DateTime<U>

Converts to this type from the input type.

impl<U> From<Option<NaiveDateTime>> for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>>,

fn from(dt: Option<NaiveDateTime>) -> DateTime<U>

Converts to this type from the input type.

impl<U> From<Option<i64>> for DateTime<U>

where U: TimeUnitTrait,

fn from(dt: Option<i64>) -> DateTime<U>

Converts to this type from the input type.

impl<U> From<i64> for DateTime<U>

where U: TimeUnitTrait,

fn from(dt: i64) -> DateTime<U>

Converts to this type from the input type.

impl<U> FromStr for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>>,

type Err = TError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<DateTime<U>, <DateTime<U> as FromStr>::Err>

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

impl<U: TimeUnitTrait> GetDataType for DateTime<U>

Available on crate feature time only.

fn dtype() -> DataType

Returns the DataType corresponding to the implementing type.

impl<U> Hash for DateTime<U>

where U: Hash + TimeUnitTrait,

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<Unit: TimeUnitTrait> IsNone for DateTime<Unit>

Available on crate feature time only.

type Inner = DateTime<Unit>

type Cast<U: IsNone<Inner = U> + Clone> = U

fn is_none(&self) -> bool

Checks if the value is in the “none” state.

fn none() -> Self

Creates a new instance of Self in the “none” state.

fn to_opt(self) -> Option<Self::Inner>

Converts the value to an Option<Self::Inner>.

fn as_opt(&self) -> Option<&Self::Inner>

Converts the value to an Option<&Self::Inner>.

fn from_inner(inner: Self::Inner) -> Self

Creates a new instance of Self from the given inner value.

fn inner_cast<U: IsNone<Inner = U> + Clone>(inner: U) -> Self::Cast<U>

where Self::Inner: Cast<U::Inner>,

Casts the inner type of Self to a new type U.

fn unwrap(self) -> Self::Inner

fn map<F, U: IsNone>(self, f: F) -> U

where F: Fn(Self::Inner) -> U::Inner,

Maps a function over the inner value of Self, if it exists.

fn from_opt(opt: Option<Self::Inner>) -> Self

Creates a new instance of Self from an Option<Self::Inner>.

fn not_none(&self) -> bool

fn sort_cmp(&self, other: &Self) -> Ordering

where Self::Inner: PartialOrd,

Compares two values for sorting, treating None as the largest value.

fn sort_cmp_rev(&self, other: &Self) -> Ordering

where Self::Inner: PartialOrd,

Compares two values for reverse sorting, treating None as the largest value.

impl<U> Ord for DateTime<U>

where U: Ord + TimeUnitTrait,

fn cmp(&self, other: &DateTime<U>) -> 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<U> PartialEq for DateTime<U>

where U: PartialEq + TimeUnitTrait,

fn eq(&self, other: &DateTime<U>) -> bool

Tests for self and other values to be equal, and is used by ==.

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<U> PartialOrd for DateTime<U>

where U: PartialOrd + TimeUnitTrait,

fn partial_cmp(&self, other: &DateTime<U>) -> 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<U> Sub<TimeDelta> for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>> + TryInto<DateTime<Utc>>,

type Output = DateTime<U>

The resulting type after applying the - operator.

fn sub(self, rhs: TimeDelta) -> <DateTime<U> as Sub<TimeDelta>>::Output

Performs the - operation.

impl<U> Sub for DateTime<U>

where U: TimeUnitTrait, DateTime<U>: From<DateTime<Utc>> + TryInto<DateTime<Utc>>,

type Output = TimeDelta

The resulting type after applying the - operator.

fn sub(self, rhs: DateTime<U>) -> <DateTime<U> as Sub>::Output

Performs the - operation.

impl TryFrom<DateTime<Microsecond>> for DateTime<Utc>

type Error = TError

The type returned in the event of a conversion error.

fn try_from(dt: DateTime<Microsecond>) -> Result<DateTime<Utc>, TError>

Performs the conversion.

impl TryFrom<DateTime<Millisecond>> for DateTime<Utc>

type Error = TError

The type returned in the event of a conversion error.

fn try_from(dt: DateTime<Millisecond>) -> Result<DateTime<Utc>, TError>

Performs the conversion.

impl TryFrom<DateTime<Second>> for DateTime<Utc>

type Error = TError

The type returned in the event of a conversion error.

fn try_from(dt: DateTime<Second>) -> Result<DateTime<Utc>, TError>

Performs the conversion.

impl TryFrom<DateTime> for DateTime<Utc>

type Error = TError

The type returned in the event of a conversion error.

fn try_from(dt: DateTime) -> Result<DateTime<Utc>, TError>

Performs the conversion.

impl<U> Copy for DateTime<U>

where U: Copy + TimeUnitTrait,

impl<U> Eq for DateTime<U>

where U: Eq + TimeUnitTrait,

impl<U> Send for DateTime<U>

where U: TimeUnitTrait,

impl<U> StructuralPartialEq for DateTime<U>

where U: TimeUnitTrait,

impl<U> Sync for DateTime<U>

where U: TimeUnitTrait,