Struct edtf::DateTime

pub struct DateTime { /* fields omitted */ }

A DateTime object.

This has minimal introspection methods. It is not an attempt to build a complete DateTime API. Prefer to use its implementation of chrono::Datelike and chrono::Timelike or simply the DateTime::to_chrono method to use a specific chrono::TimeZone, all available with features = ["chrono"].

Also, its Display implementation is geared towards lossless EDTF parse-format roundtrips. It does not always produce valid RFC3339 timestamps, in particular TzOffset::Hours is rendered as +04 instead of +04:00. This is best considered a problem with the EDTF specification for allowing a useless extra timestamp format.

Implementations

impl DateTime

pub fn date(&self) -> DateComplete

Gets the date portion

pub fn time(&self) -> Time

Gets the time portion

pub fn offset(&self) -> TzOffset

Get the TzOffset. If None is returned, this represents a timestamp which did not specify a timezone.

If using the chrono interop, None means you should attempt to convert to a chrono::NaiveDate

pub fn to_chrono_naive(&self) -> NaiveDateTime

This is supported on crate feature chrono only.

Convert to a chrono::NaiveDate

pub fn to_chrono<Tz>(&self, tz: &Tz) -> DateTime<Tz> where
    Tz: TimeZone, 

This is supported on crate feature chrono only.

use edtf::level_1::Edtf;
use chrono::TimeZone;

let utc = chrono::Utc;
assert_eq!(
    Edtf::parse("2004-02-29T01:47:00+05:00")
        .unwrap()
        .as_datetime()
        .unwrap()
        .to_chrono(&utc),
    utc.ymd(2004, 02, 28).and_hms(20, 47, 00)
);

Trait Implementations

impl Clone for DateTime

fn clone(&self) -> DateTime

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Datelike for DateTime

This is supported on crate feature chrono only.

Convenience chrono::Datelike implementation, which mostly relies on internal conversion to chrono::NaiveDate.

fn year(&self) -> i32

Returns the year number in the calendar date.

fn month(&self) -> u32

Returns the month number starting from 1.

fn month0(&self) -> u32

Returns the month number starting from 0.

fn day(&self) -> u32

Returns the day of month starting from 1.

fn day0(&self) -> u32

Returns the day of month starting from 0.

fn ordinal(&self) -> u32

Returns the day of year starting from 1.

fn ordinal0(&self) -> u32

Returns the day of year starting from 0.

fn weekday(&self) -> Weekday

Returns the day of week.

fn iso_week(&self) -> IsoWeek

Returns the ISO week.

fn with_year(&self, year: i32) -> Option<Self>

Makes a new value with the year number changed.

fn with_month(&self, month: u32) -> Option<Self>

Makes a new value with the month number (starting from 1) changed.

fn with_month0(&self, month0: u32) -> Option<Self>

Makes a new value with the month number (starting from 0) changed.

fn with_day(&self, day: u32) -> Option<Self>

Makes a new value with the day of month (starting from 1) changed.

fn with_day0(&self, day0: u32) -> Option<Self>

Makes a new value with the day of month (starting from 0) changed.

fn with_ordinal(&self, ordinal: u32) -> Option<Self>

Makes a new value with the day of year (starting from 1) changed.

fn with_ordinal0(&self, ordinal0: u32) -> Option<Self>

Makes a new value with the day of year (starting from 0) changed.

fn year_ce(&self) -> (bool, u32)

Returns the absolute year number starting from 1 with a boolean flag, which is false when the year predates the epoch (BCE/BC) and true otherwise (CE/AD).

fn num_days_from_ce(&self) -> i32

Counts the days in the proleptic Gregorian calendar, with January 1, Year 1 (CE) as day 1.

impl Debug for DateTime

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

Formats the value using the given formatter.

impl Display for DateTime

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

Formats the value using the given formatter.

impl<DT> From<DT> for DateTime where
    DT: Datelike,
    DT: Timelike,
    DT: GetTimezone, 

This is supported on crate feature chrono only.

fn from(chrono_dt: DT) -> DateTime

Performs the conversion.

impl Hash for DateTime

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<DateTime> for DateTime

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

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

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

This method tests for !=.

impl Timelike for DateTime

This is supported on crate feature chrono only.

fn hour(&self) -> u32

Returns the hour number from 0 to 23.

fn minute(&self) -> u32

Returns the minute number from 0 to 59.

fn second(&self) -> u32

Returns the second number from 0 to 59.

fn nanosecond(&self) -> u32

Returns the number of nanoseconds since the whole non-leap second. The range from 1,000,000,000 to 1,999,999,999 represents the leap second.

fn with_hour(&self, hour: u32) -> Option<Self>

Makes a new value with the hour number changed.

fn with_minute(&self, min: u32) -> Option<Self>

Makes a new value with the minute number changed.

fn with_second(&self, sec: u32) -> Option<Self>

Makes a new value with the second number changed.

fn with_nanosecond(&self, _nano: u32) -> Option<Self>

Makes a new value with nanoseconds since the whole non-leap second changed.

fn hour12(&self) -> (bool, u32)

Returns the hour number from 1 to 12 with a boolean flag, which is false for AM and true for PM.

fn num_seconds_from_midnight(&self) -> u32

Returns the number of non-leap seconds past the last midnight.

impl Copy for DateTime

impl Eq for DateTime

impl StructuralEq for DateTime

impl StructuralPartialEq for DateTime