Struct chrono::date::Date
[-] [+]
[src]
pub struct Date<Tz: TimeZone> { // some fields omitted }
ISO 8601 calendar date with time zone.
Methods
impl<Tz: TimeZone> Date<Tz>
fn from_utc(date: NaiveDate, offset: Offset) -> Date<Tz>
Makes a new Date
with given UTC date and offset.
The local date should be constructed via the TimeZone
trait.
fn and_time(&self, time: NaiveTime) -> Option<DateTime<Tz>>
Makes a new DateTime
from the current date and given NaiveTime
.
The offset in the current date is preserved.
Fails on invalid datetime.
fn and_hms(&self, hour: u32, min: u32, sec: u32) -> DateTime<Tz>
Makes a new DateTime
from the current date, hour, minute and second.
The offset in the current date is preserved.
Fails on invalid hour, minute and/or second.
fn and_hms_opt(&self, hour: u32, min: u32, sec: u32) -> Option<DateTime<Tz>>
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.
fn and_hms_milli(&self, hour: u32, min: u32, sec: u32, milli: u32) -> DateTime<Tz>
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.
Fails on invalid hour, minute, second and/or millisecond.
fn and_hms_milli_opt(&self, hour: u32, min: u32, sec: u32, milli: u32) -> Option<DateTime<Tz>>
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.
fn and_hms_micro(&self, hour: u32, min: u32, sec: u32, micro: u32) -> DateTime<Tz>
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.
Fails on invalid hour, minute, second and/or microsecond.
fn and_hms_micro_opt(&self, hour: u32, min: u32, sec: u32, micro: u32) -> Option<DateTime<Tz>>
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.
fn and_hms_nano(&self, hour: u32, min: u32, sec: u32, nano: u32) -> DateTime<Tz>
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.
Fails on invalid hour, minute, second and/or nanosecond.
fn and_hms_nano_opt(&self, hour: u32, min: u32, sec: u32, nano: u32) -> Option<DateTime<Tz>>
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.
fn succ(&self) -> Date<Tz>
Makes a new Date
for the next date.
Fails when self
is the last representable date.
fn succ_opt(&self) -> Option<Date<Tz>>
Makes a new Date
for the next date.
Returns None
when self
is the last representable date.
fn pred(&self) -> Date<Tz>
Makes a new Date
for the prior date.
Fails when self
is the first representable date.
fn pred_opt(&self) -> Option<Date<Tz>>
Makes a new Date
for the prior date.
Returns None
when self
is the first representable date.
fn offset<'a>(&'a self) -> &'a Offset
Retrieves an associated offset from UTC.
fn timezone(&self) -> Tz
Retrieves an associated time zone.
fn with_timezone<Tz2: TimeZone>(&self, tz: &Tz2) -> Date<Tz2>
Changes the associated time zone.
This does not change the actual Date
(but will change the string representation).
fn checked_add(self, rhs: Duration) -> Option<Date<Tz>>
Adds given Duration
to the current date.
Returns None
when it will result in overflow.
fn checked_sub(self, rhs: Duration) -> Option<Date<Tz>>
Subtracts given Duration
from the current date.
Returns None
when it will result in overflow.
fn naive_utc(&self) -> NaiveDate
Returns a view to the naive UTC date.
fn naive_local(&self) -> NaiveDate
Returns a view to the naive local date.
impl<Tz: TimeZone> Date<Tz> where Offset: Display
fn format_with_items<'a, I>(&self, items: I) -> DelayedFormat<I> where I: Iterator<Item=Item<'a>> + Clone
Formats the date with the specified formatting items.
fn format<'a>(&self, fmt: &'a str) -> DelayedFormat<StrftimeItems<'a>>
Formats the date with the specified format string.
See the format::strftime
module on the supported escape sequences.