Struct chrono::Date [−][src]
pub struct Date<Tz: TimeZone> { /* fields omitted */ }
Expand description
ISO 8601 calendar date with time zone.
This type should be considered ambiguous at best,
due to the inherent lack of precision required for the time zone resolution.
For serialization and deserialization uses, it is best to use NaiveDate
instead.
There are some guarantees on the usage of Date<Tz>
:
-
If properly constructed via
TimeZone::ymd
and others without an error, the corresponding local date should exist for at least a moment. (It may still have a gap from the offset changes.) -
The
TimeZone
is free to assign anyOffset
to the local date, as long as that offset did occur in given day. For example, if2015-03-08T01:59-08:00
is followed by2015-03-08T03:00-07:00
, it may produce either2015-03-08-08:00
or2015-03-08-07:00
but not2015-03-08+00:00
and others. -
Once constructed as a full
DateTime
,DateTime::date
and other associated methods should return those for the originalDate
. For example, ifdt = tz.ymd(y,m,d).hms(h,n,s)
were valid,dt.date() == tz.ymd(y,m,d)
. -
The date is timezone-agnostic up to one day (i.e. practically always), so the local date and UTC date should be equal for most cases even though the raw calculation between
NaiveDate
andDuration
may not.
Implementations
Makes a new Date
with given UTC date and offset.
The local date should be constructed via the TimeZone
trait.
Makes a new DateTime
from the current date and given NaiveTime
.
The offset in the current date is preserved.
Panics on invalid datetime.
Makes a new DateTime
from the current date, hour, minute and second.
The offset in the current date is preserved.
Panics on invalid hour, minute and/or second.
Makes a new DateTime
from the current date, hour, minute and second.
The offset in the current date is preserved.
Returns None
on invalid hour, minute and/or second.
Makes a new DateTime
from the current date, hour, minute, second and millisecond.
The millisecond part can exceed 1,000 in order to represent the leap second.
The offset in the current date is preserved.
Panics on invalid hour, minute, second and/or millisecond.
Makes a new DateTime
from the current date, hour, minute, second and millisecond.
The millisecond part can exceed 1,000 in order to represent the leap second.
The offset in the current date is preserved.
Returns None
on invalid hour, minute, second and/or millisecond.
Makes a new DateTime
from the current date, hour, minute, second and microsecond.
The microsecond part can exceed 1,000,000 in order to represent the leap second.
The offset in the current date is preserved.
Panics on invalid hour, minute, second and/or microsecond.
Makes a new DateTime
from the current date, hour, minute, second and microsecond.
The microsecond part can exceed 1,000,000 in order to represent the leap second.
The offset in the current date is preserved.
Returns None
on invalid hour, minute, second and/or microsecond.
Makes a new DateTime
from the current date, hour, minute, second and nanosecond.
The nanosecond part can exceed 1,000,000,000 in order to represent the leap second.
The offset in the current date is preserved.
Panics on invalid hour, minute, second and/or nanosecond.
Makes a new DateTime
from the current date, hour, minute, second and nanosecond.
The nanosecond part can exceed 1,000,000,000 in order to represent the leap second.
The offset in the current date is preserved.
Returns None
on invalid hour, minute, second and/or nanosecond.
Makes a new Date
for the next date.
Panics when self
is the last representable date.
Makes a new Date
for the next date.
Returns None
when self
is the last representable date.
Makes a new Date
for the prior date.
Panics when self
is the first representable date.
Makes a new Date
for the prior date.
Returns None
when self
is the first representable date.
Changes the associated time zone.
This does not change the actual Date
(but will change the string representation).
Adds given Duration
to the current date.
Returns None
when it will result in overflow.
Subtracts given Duration
from the current date.
Returns None
when it will result in overflow.
Subtracts another Date
from the current date.
Returns a Duration
of integral numbers.
This does not overflow or underflow at all,
as all possible output fits in the range of Duration
.
Returns a view to the naive local date.
This is technically the same as naive_utc
because the offset is restricted to never exceed one day,
but provided for the consistency.
pub fn format_with_items<'a, I, B>(&self, items: I) -> DelayedFormat<I> where
I: Iterator<Item = B> + Clone,
B: Borrow<Item<'a>>,
pub fn format_with_items<'a, I, B>(&self, items: I) -> DelayedFormat<I> where
I: Iterator<Item = B> + Clone,
B: Borrow<Item<'a>>,
Formats the date with the specified formatting items.
Formats the date with the specified format string.
See the format::strftime
module
on the supported escape sequences.
Trait Implementations
Returns the year number in the calendar date.
Makes a new value with the year number changed. Read more
Makes a new value with the month number (starting from 1) changed. Read more
Makes a new value with the month number (starting from 0) changed. Read more
Makes a new value with the day of month (starting from 1) changed. Read more
Makes a new value with the day of month (starting from 0) changed. Read more
Makes a new value with the day of year (starting from 1) changed. Read more
Makes a new value with the day of year (starting from 0) changed. Read more
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). Read more
Counts the days in the proleptic Gregorian calendar, with January 1, Year 1 (CE) as day 1. Read more
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
type Output = OldDuration
type Output = OldDuration
The resulting type after applying the -
operator.
Performs the -
operation. Read more
Auto Trait Implementations
impl<Tz> RefUnwindSafe for Date<Tz> where
<Tz as TimeZone>::Offset: RefUnwindSafe,
impl<Tz> UnwindSafe for Date<Tz> where
<Tz as TimeZone>::Offset: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more