[−][src]Struct mail_headers::header_components::DateTime
A DateTime header component wrapping chrono::DateTime<chrono::Utc>
Methods
impl DateTime
[src]
pub fn now() -> DateTime
[src]
create a new DateTime of the current Time
pub fn new<TZ: TimeZone>(date_time: DateTime<TZ>) -> DateTime
[src]
create a new DateTime from a chrono::DateTime<TimeZone>
for any TimeZone
Methods from Deref<Target = DateTime<Utc>>
pub fn date(&self) -> Date<Tz>
[src]
Retrieves a date component.
pub fn time(&self) -> NaiveTime
[src]
Retrieves a time component.
Unlike date
, this is not associated to the time zone.
pub fn timestamp(&self) -> i64
[src]
Returns the number of non-leap seconds since January 1, 1970 0:00:00 UTC (aka "UNIX timestamp").
pub fn timestamp_millis(&self) -> i64
[src]
Returns the number of non-leap-milliseconds since January 1, 1970 UTC
Note that this does reduce the number of years that can be represented from ~584 Billion to ~584 Million. (If this is a problem, please file an issue to let me know what domain needs millisecond precision over billions of years, I'm curious.)
Example
use chrono::Utc; use chrono::TimeZone; let dt = Utc.ymd(1970, 1, 1).and_hms_milli(0, 0, 1, 444); assert_eq!(dt.timestamp_millis(), 1_444); let dt = Utc.ymd(2001, 9, 9).and_hms_milli(1, 46, 40, 555); assert_eq!(dt.timestamp_millis(), 1_000_000_000_555);
pub fn timestamp_nanos(&self) -> i64
[src]
Returns the number of non-leap-nanoseconds since January 1, 1970 UTC
Note that this does reduce the number of years that can be represented from ~584 Billion to ~584. (If this is a problem, please file an issue to let me know what domain needs nanosecond precision over millenia, I'm curious.)
Example
use chrono::Utc; use chrono::TimeZone; let dt = Utc.ymd(1970, 1, 1).and_hms_nano(0, 0, 1, 444); assert_eq!(dt.timestamp_nanos(), 1_000_000_444); let dt = Utc.ymd(2001, 9, 9).and_hms_nano(1, 46, 40, 555); assert_eq!(dt.timestamp_nanos(), 1_000_000_000_000_000_555);
pub fn timestamp_subsec_millis(&self) -> u32
[src]
Returns the number of milliseconds since the last second boundary
warning: in event of a leap second, this may exceed 999
note: this is not the number of milliseconds since January 1, 1970 0:00:00 UTC
pub fn timestamp_subsec_micros(&self) -> u32
[src]
Returns the number of microseconds since the last second boundary
warning: in event of a leap second, this may exceed 999_999
note: this is not the number of microseconds since January 1, 1970 0:00:00 UTC
pub fn timestamp_subsec_nanos(&self) -> u32
[src]
Returns the number of nanoseconds since the last second boundary
warning: in event of a leap second, this may exceed 999_999_999
note: this is not the number of nanoseconds since January 1, 1970 0:00:00 UTC
pub fn offset(&self) -> &<Tz as TimeZone>::Offset
[src]
Retrieves an associated offset from UTC.
pub fn timezone(&self) -> Tz
[src]
Retrieves an associated time zone.
pub fn with_timezone<Tz2>(&self, tz: &Tz2) -> DateTime<Tz2> where
Tz2: TimeZone,
[src]
Tz2: TimeZone,
Changes the associated time zone.
This does not change the actual DateTime
(but will change the string representation).
pub fn naive_utc(&self) -> NaiveDateTime
[src]
Returns a view to the naive UTC datetime.
pub fn naive_local(&self) -> NaiveDateTime
[src]
Returns a view to the naive local datetime.
pub fn to_rfc2822(&self) -> String
[src]
Returns an RFC 2822 date and time string such as Tue, 1 Jul 2003 10:52:37 +0200
.
pub fn to_rfc3339(&self) -> String
[src]
Returns an RFC 3339 and ISO 8601 date and time string such as 1996-12-19T16:39:57-08:00
.
pub fn to_rfc3339_opts(&self, secform: SecondsFormat, use_z: bool) -> String
[src]
Return an RFC 3339 and ISO 8601 date and time string with subseconds
formatted as per a SecondsFormat
. If passed use_z
true and the
timezone is UTC (offset 0), use 'Z', as per
Fixed::TimezoneOffsetColonZ.
If passed use_z
false, use
Fixed::TimezoneOffsetColon.
Examples
let dt = Utc.ymd(2018, 1, 26).and_hms_micro(18, 30, 9, 453_829); assert_eq!(dt.to_rfc3339_opts(SecondsFormat::Millis, false), "2018-01-26T18:30:09.453+00:00"); assert_eq!(dt.to_rfc3339_opts(SecondsFormat::Millis, true), "2018-01-26T18:30:09.453Z"); assert_eq!(dt.to_rfc3339_opts(SecondsFormat::Secs, true), "2018-01-26T18:30:09Z"); let pst = FixedOffset::east(8 * 60 * 60); let dt = pst.ymd(2018, 1, 26).and_hms_micro(10, 30, 9, 453_829); assert_eq!(dt.to_rfc3339_opts(SecondsFormat::Secs, true), "2018-01-26T10:30:09+08:00");
pub fn format_with_items<'a, I>(&self, items: I) -> DelayedFormat<I> where
I: Iterator<Item = Item<'a>> + Clone,
[src]
I: Iterator<Item = Item<'a>> + Clone,
Formats the combined date and time with the specified formatting items.
pub fn format(&self, fmt: &'a str) -> DelayedFormat<StrftimeItems<'a>>
[src]
Formats the combined date and time with the specified format string.
See the format::strftime
module
on the supported escape sequences.
Trait Implementations
impl<TZ> HeaderTryFrom<DateTime<TZ>> for DateTime where
TZ: TimeZone,
[src]
TZ: TimeZone,
fn try_from(val: DateTime<TZ>) -> Result<Self, ComponentCreationError>
[src]
impl Into<DateTime<Utc>> for DateTime
[src]
impl PartialEq<DateTime> for DateTime
[src]
impl<TZ> From<DateTime<TZ>> for DateTime where
TZ: TimeZone,
[src]
TZ: TimeZone,
impl Clone for DateTime
[src]
fn clone(&self) -> DateTime
[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Eq for DateTime
[src]
impl Debug for DateTime
[src]
impl Hash for DateTime
[src]
fn hash<__H: Hasher>(&self, state: &mut __H)
[src]
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
Feeds a slice of this type into the given [Hasher
]. Read more
impl Deref for DateTime
[src]
type Target = DateTime<Utc>
The resulting type after dereferencing.
fn deref(&self) -> &Self::Target
[src]
impl Serialize for DateTime
[src]
fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
__S: Serializer,
[src]
__S: Serializer,
impl<'de> Deserialize<'de> for DateTime
[src]
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
[src]
__D: Deserializer<'de>,
impl EncodableInHeader for DateTime
[src]
fn encode(&self, handle: &mut EncodingWriter) -> Result<(), EncodingError>
[src]
fn boxed_clone(&self) -> Box<dyn EncodableInHeader>
[src]
Auto Trait Implementations
Blanket Implementations
impl<T, U> Into for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
impl<T> From for T
[src]
impl<T, U> TryFrom for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T> Borrow for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> Erased for T
[src]
impl<T> DeserializeOwned for T where
T: Deserialize<'de>,
[src]
T: Deserialize<'de>,