Struct DateTime 

pub struct DateTime(/* private fields */);

A wrapper type for chrono::DateTime<Local>.

Implementations

impl DateTime

pub fn now() -> Self

Returns a new instance which corresponds to the current date and time.

pub fn current_timestamp() -> i64

Returns the number of non-leap seconds since the midnight UTC on January 1, 1970.

pub fn current_timestamp_millis() -> i64

Returns the number of non-leap milliseconds since the midnight UTC on January 1, 1970.

pub fn current_timestamp_micros() -> i64

Returns the number of non-leap microseconds since the midnight UTC on January 1, 1970.

pub fn current_timestamp_nanos() -> i64

Returns the number of non-leap nanoseconds since the midnight UTC on January 1, 1970.

pub fn from_timestamp(secs: i64) -> Self

Returns a new instance corresponding to a UTC date and time, from the number of non-leap seconds since the midnight UTC on January 1, 1970.

pub fn from_timestamp_millis(millis: i64) -> Self

Returns a new instance corresponding to a UTC date and time, from the number of non-leap milliseconds since the midnight UTC on January 1, 1970.

pub fn from_timestamp_micros(micros: i64) -> Self

Returns a new instance corresponding to a UTC date and time, from the number of non-leap microseconds since the midnight UTC on January 1, 1970.

pub fn from_timestamp_nanos(nanos: i64) -> Self

Returns a new instance corresponding to a UTC date and time, from the number of non-leap nanoseconds since the midnight UTC on January 1, 1970.

pub fn from_uuid_timestamp(ts: Timestamp) -> Self

Returns a new instance corresponding to a UTC date and time from a UUID timestamp.

pub fn timestamp(&self) -> i64

Returns the number of non-leap seconds since the midnight UTC on January 1, 1970.

pub fn timestamp_millis(&self) -> i64

Returns the number of non-leap milliseconds since the midnight UTC on January 1, 1970.

pub fn timestamp_micros(&self) -> i64

Returns the number of non-leap microseconds since the midnight UTC on January 1, 1970.

pub fn timestamp_nanos(&self) -> i64

Returns the number of non-leap nanoseconds since the midnight UTC on January 1, 1970.

pub fn uuid_timestamp(&self) -> Timestamp

Returns a timestamp that can be encoded into a UUID.

pub fn timezone_offset(&self) -> i32

Returns the difference in seconds between self and the same date-time as evaluated in the UTC time zone.

pub fn parse_utc_str(s: &str) -> Result<Self, ParseError>

Parses an RFC 2822 date and time.

pub fn parse_iso_str(s: &str) -> Result<Self, ParseError>

Parses an RFC 3339 and ISO 8601 date and time.

pub fn parse_from_str(s: &str, fmt: &str) -> Result<Self, ParseError>

Parses a string with the specified format string. See format::strftime for the supported escape sequences.

pub fn to_utc_timestamp(&self) -> String

Returns a UTC timestamp string.

pub fn to_utc_string(&self) -> String

Returns an RFC 2822 date and time string.

pub fn to_iso_string(&self) -> String

Return an RFC 3339 and ISO 8601 date and time string with subseconds formatted as SecondsFormat::Millis.

pub fn to_local_string(&self) -> String

Returns a date-time string with the Local time zone.

pub fn format(&self, fmt: &str) -> String

Formats the combined date and time with the specified format string. See format::strftime for the supported escape sequences.

pub fn format_date(&self) -> String

Returns a date-only string in the format %Y-%m-%d.

pub fn format_time(&self) -> String

Returns a time-only string in the format %H:%M:%S.

pub fn format_local(&self) -> String

Returns a date-time string in the format %Y-%m-%d %H:%M:%S with the Local time zone.

pub fn format_utc(&self) -> String

Returns a date-time string in the format %Y-%m-%d %H:%M:%S with the Utc time zone.

pub fn duration_since(&self, earlier: DateTime) -> Duration

Returns the amount of time elapsed from another datetime to this one, or zero duration if that datetime is later than this one.

pub fn span_between(&self, other: DateTime) -> Duration

Returns the duration of time between self and other.

pub fn span_between_now(&self) -> Duration

Returns the duration of time between self and DateTime::now().

pub fn span_before_now(&self) -> Option<Duration>

Returns the duration of time from self to DateTime::now().

pub fn span_after_now(&self) -> Option<Duration>

Returns the duration of time from DateTime::now() to self.

pub fn date(&self) -> Date

Retrieves the date component.

pub fn time(&self) -> Time

Retrieves the time component.

pub fn year(&self) -> i32

Returns the year number in the calendar date.

pub fn quarter(&self) -> u32

Returns the quarter number starting from 1.

The return value ranges from 1 to 4.

pub fn month(&self) -> u32

Returns the month number starting from 1.

The return value ranges from 1 to 12.

pub fn day(&self) -> u32

Returns the day of month starting from 1.

The return value ranges from 1 to 31. (The last day of month differs by months.)

pub fn hour(&self) -> u32

Returns the hour number from 0 to 23.

pub fn minute(&self) -> u32

Returns the minute number from 0 to 59.

pub fn second(&self) -> u32

Returns the second number from 0 to 59.

pub fn millisecond(&self) -> u32

Returns the millisecond number from 0 to 999.

pub fn microsecond(&self) -> u32

Returns the microsecond number from 0 to 999.

pub fn nanosecond(&self) -> u32

Returns the nanosecond number from 0 to 999.

pub fn week(&self) -> u32

Returns the ISO week number starting from 1.

The return value ranges from 1 to 53. (The last week of year differs by years.)

pub fn day_of_year(&self) -> u32

Returns the day of year starting from 1.

The return value ranges from 1 to 366. (The last day of year differs by years.)

pub fn day_of_week(&self) -> u8

Returns the day of week starting from 0 (Sunday) to 6 (Saturday).

pub fn iso_day_of_week(&self) -> u8

Returns the ISO day of week starting from 1 (Monday) to 7 (Sunday).

pub fn is_leap_year(&self) -> bool

Returns true if the current year is a leap year.

pub fn is_weekend(&self) -> bool

Returns true if the current day is weekend.

pub fn days_in_current_year(&self) -> u32

Returns the number of days in the current year.

pub fn days_in_current_month(&self) -> u32

Returns the number of days in the current month.

pub fn start_of_current_year(&self) -> Self

Returns the start of the current year.

pub fn end_of_current_year(&self) -> Self

Returns the end of the current year.

pub fn start_of_current_quarter(&self) -> Self

Returns the start of the current quarter.

pub fn end_of_current_quarter(&self) -> Self

Returns the end of the current quarter.

pub fn start_of_current_month(&self) -> Self

Returns the start of the current month.

pub fn end_of_current_month(&self) -> Self

Returns the end of the current month.

pub fn start_of_current_day(&self) -> Self

Returns the start of the current day.

pub fn end_of_current_day(&self) -> Self

Returns the end of the current day.

pub fn start_of_year(year: i32) -> Self

Returns the start of the year.

pub fn end_of_year(year: i32) -> Self

Returns the end of the year.

pub fn start_of_month(year: i32, month: u32) -> Self

Returns the start of the month.

pub fn end_of_month(year: i32, month: u32) -> Self

Returns the end of the month.

pub fn start_of_day(year: i32, month: u32, day: u32) -> Self

Returns the start of the day.

pub fn end_of_day(year: i32, month: u32, day: u32) -> Self

Returns the end of the month.

pub fn checked_add_months(self, months: u32) -> Option<Self>

Adds a duration in months to the date part of the DateTime. Returns None if the resulting date would be out of range.

pub fn checked_sub_months(self, months: u32) -> Option<Self>

Subtracts a duration in months from the date part of the DateTime. Returns None if the resulting date would be out of range.

pub fn checked_add_days(self, days: u32) -> Option<Self>

Adds a duration in days to the date part of the DateTime. Returns None if the resulting date would be out of range.

pub fn checked_sub_days(self, days: u32) -> Option<Self>

Subtracts a duration in days from the date part of the DateTime. Returns None if the resulting date would be out of range.

Trait Implementations

impl Add<Duration> for DateTime

type Output = DateTime

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<Duration> for DateTime

fn add_assign(&mut self, rhs: Duration)

Performs the += operation.

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 Debug for DateTime

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

Formats the value using the given formatter.

impl<'r, DB> Decode<'r, DB> for DateTime

where DB: Database, DateTime<Local>: Decode<'r, DB>,

Available on crate feature sqlx only.

fn decode(value: <DB as Database>::ValueRef<'r>) -> Result<Self, BoxError>

Decode a new value of this type using a raw value from the database.

impl Default for DateTime

fn default() -> Self

Returns an instance which corresponds to the current date and time.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for DateTime

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

Formats the value using the given formatter.

impl From<Date> for DateTime

fn from(d: Date) -> Self

Converts to this type from the input type.

impl From<DateTime<Local>> for DateTime

fn from(dt: DateTime<Local>) -> Self

Converts to this type from the input type.

impl From<DateTime> for DateTime<Local>

fn from(dt: DateTime) -> Self

Converts to this type from the input type.

impl<'a> From<DateTime> for FluentValue<'a>

Available on crate feature i18n only.

fn from(dt: DateTime) -> Self

Converts to this type from the input type.

impl From<DateTime> for AvroValue

fn from(dt: DateTime) -> Self

Converts to this type from the input type.

impl From<DateTime> for JsonValue

fn from(dt: DateTime) -> Self

Converts to this type from the input type.

impl FromStr for DateTime

type Err = ParseError

The associated error which can be returned from parsing.

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

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

impl Ord for DateTime

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

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

type Output = DateTime

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<Duration> for DateTime

fn sub_assign(&mut self, rhs: Duration)

Performs the -= operation.

impl<DB> Type<DB> for DateTime

where DB: Database, DateTime<Local>: Type<DB>,

Available on crate feature sqlx only.

fn type_info() -> <DB as Database>::TypeInfo

Returns the canonical SQL type for this Rust type.

fn compatible(ty: &<DB as Database>::TypeInfo) -> bool

Determines if this Rust type is compatible with the given SQL type.

impl Copy for DateTime

impl Eq for DateTime

impl StructuralPartialEq for DateTime