Struct prayers::Date [−][src]
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
impl<Tz> Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
pub fn from_utc(date: NaiveDate, offset: <Tz as TimeZone>::Offset) -> Date<Tz>
[src]
Makes a new Date
with given UTC date and offset.
The local date should be constructed via the TimeZone
trait.
pub fn and_time(&self, time: NaiveTime) -> Option<DateTime<Tz>>
[src]
Makes a new DateTime
from the current date and given NaiveTime
.
The offset in the current date is preserved.
Panics on invalid datetime.
pub fn and_hms(&self, hour: u32, min: u32, sec: u32) -> DateTime<Tz>
[src]
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.
pub fn and_hms_opt(&self, hour: u32, min: u32, sec: u32) -> Option<DateTime<Tz>>
[src]
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.
pub fn and_hms_milli(
&self,
hour: u32,
min: u32,
sec: u32,
milli: u32
) -> DateTime<Tz>
[src]
&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.
Panics on invalid hour, minute, second and/or millisecond.
pub fn and_hms_milli_opt(
&self,
hour: u32,
min: u32,
sec: u32,
milli: u32
) -> Option<DateTime<Tz>>
[src]
&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.
pub fn and_hms_micro(
&self,
hour: u32,
min: u32,
sec: u32,
micro: u32
) -> DateTime<Tz>
[src]
&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.
Panics on invalid hour, minute, second and/or microsecond.
pub fn and_hms_micro_opt(
&self,
hour: u32,
min: u32,
sec: u32,
micro: u32
) -> Option<DateTime<Tz>>
[src]
&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.
pub fn and_hms_nano(
&self,
hour: u32,
min: u32,
sec: u32,
nano: u32
) -> DateTime<Tz>
[src]
&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.
Panics on invalid hour, minute, second and/or nanosecond.
pub fn and_hms_nano_opt(
&self,
hour: u32,
min: u32,
sec: u32,
nano: u32
) -> Option<DateTime<Tz>>
[src]
&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.
pub fn succ(&self) -> Date<Tz>
[src]
Makes a new Date
for the next date.
Panics when self
is the last representable date.
pub fn succ_opt(&self) -> Option<Date<Tz>>
[src]
Makes a new Date
for the next date.
Returns None
when self
is the last representable date.
pub fn pred(&self) -> Date<Tz>
[src]
Makes a new Date
for the prior date.
Panics when self
is the first representable date.
pub fn pred_opt(&self) -> Option<Date<Tz>>
[src]
Makes a new Date
for the prior date.
Returns None
when self
is the first representable date.
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) -> Date<Tz2> where
Tz2: TimeZone,
[src]
Tz2: TimeZone,
Changes the associated time zone.
This does not change the actual Date
(but will change the string representation).
pub fn checked_add_signed(self, rhs: Duration) -> Option<Date<Tz>>
[src]
Adds given Duration
to the current date.
Returns None
when it will result in overflow.
pub fn checked_sub_signed(self, rhs: Duration) -> Option<Date<Tz>>
[src]
Subtracts given Duration
from the current date.
Returns None
when it will result in overflow.
pub fn signed_duration_since<Tz2>(self, rhs: Date<Tz2>) -> Duration where
Tz2: TimeZone,
[src]
Tz2: TimeZone,
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
.
pub fn naive_utc(&self) -> NaiveDate
[src]
Returns a view to the naive UTC date.
pub fn naive_local(&self) -> NaiveDate
[src]
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.
impl<Tz> Date<Tz> where
Tz: TimeZone,
<Tz as TimeZone>::Offset: Display,
[src]
Tz: TimeZone,
<Tz as TimeZone>::Offset: Display,
pub fn format_with_items<'a, I, B>(&self, items: I) -> DelayedFormat<I> where
I: Iterator<Item = B> + Clone,
B: Borrow<Item<'a>>,
[src]
I: Iterator<Item = B> + Clone,
B: Borrow<Item<'a>>,
Formats the date with the specified formatting items.
pub fn format(&self, fmt: &'a str) -> DelayedFormat<StrftimeItems<'a>>
[src]
Formats the date with the specified format string.
See the format::strftime
module
on the supported escape sequences.
Trait Implementations
impl<Tz> Add<Duration> for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
type Output = Date<Tz>
The resulting type after applying the +
operator.
pub fn add(self, rhs: Duration) -> Date<Tz>
[src]
impl<Tz> Clone for Date<Tz> where
Tz: Clone + TimeZone,
<Tz as TimeZone>::Offset: Clone,
[src]
Tz: Clone + TimeZone,
<Tz as TimeZone>::Offset: Clone,
impl<Tz> Copy for Date<Tz> where
Tz: TimeZone,
<Tz as TimeZone>::Offset: Copy,
[src]
Tz: TimeZone,
<Tz as TimeZone>::Offset: Copy,
impl<Tz> Datelike for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
pub fn year(&self) -> i32
[src]
pub fn month(&self) -> u32
[src]
pub fn month0(&self) -> u32
[src]
pub fn day(&self) -> u32
[src]
pub fn day0(&self) -> u32
[src]
pub fn ordinal(&self) -> u32
[src]
pub fn ordinal0(&self) -> u32
[src]
pub fn weekday(&self) -> Weekday
[src]
pub fn iso_week(&self) -> IsoWeek
[src]
pub fn with_year(&self, year: i32) -> Option<Date<Tz>>
[src]
pub fn with_month(&self, month: u32) -> Option<Date<Tz>>
[src]
pub fn with_month0(&self, month0: u32) -> Option<Date<Tz>>
[src]
pub fn with_day(&self, day: u32) -> Option<Date<Tz>>
[src]
pub fn with_day0(&self, day0: u32) -> Option<Date<Tz>>
[src]
pub fn with_ordinal(&self, ordinal: u32) -> Option<Date<Tz>>
[src]
pub fn with_ordinal0(&self, ordinal0: u32) -> Option<Date<Tz>>
[src]
pub fn year_ce(&self) -> (bool, u32)
[src]
pub fn num_days_from_ce(&self) -> i32
[src]
impl<Tz> Debug for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
impl<Tz> Display for Date<Tz> where
Tz: TimeZone,
<Tz as TimeZone>::Offset: Display,
[src]
Tz: TimeZone,
<Tz as TimeZone>::Offset: Display,
impl<Tz> Eq for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
impl<Tz> Hash for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
pub fn hash<H>(&self, state: &mut H) where
H: Hasher,
[src]
H: Hasher,
pub fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
impl<Tz> Ord for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
pub fn cmp(&self, other: &Date<Tz>) -> Ordering
[src]
#[must_use]pub fn max(self, other: Self) -> Self
1.21.0[src]
#[must_use]pub fn min(self, other: Self) -> Self
1.21.0[src]
#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self
1.50.0[src]
impl<Tz, Tz2> PartialEq<Date<Tz2>> for Date<Tz> where
Tz: TimeZone,
Tz2: TimeZone,
[src]
Tz: TimeZone,
Tz2: TimeZone,
pub fn eq(&self, other: &Date<Tz2>) -> bool
[src]
#[must_use]pub fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
impl<Tz> PartialOrd<Date<Tz>> for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
pub fn partial_cmp(&self, other: &Date<Tz>) -> Option<Ordering>
[src]
#[must_use]pub fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]pub fn le(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]pub fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]pub fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
impl<Tz> Send for Date<Tz> where
Tz: TimeZone,
<Tz as TimeZone>::Offset: Send,
[src]
Tz: TimeZone,
<Tz as TimeZone>::Offset: Send,
impl<Tz> Sub<Date<Tz>> for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
type Output = Duration
The resulting type after applying the -
operator.
pub fn sub(self, rhs: Date<Tz>) -> Duration
[src]
impl<Tz> Sub<Duration> for Date<Tz> where
Tz: TimeZone,
[src]
Tz: TimeZone,
Auto Trait Implementations
impl<Tz> RefUnwindSafe for Date<Tz> where
<Tz as TimeZone>::Offset: RefUnwindSafe,
<Tz as TimeZone>::Offset: RefUnwindSafe,
impl<Tz> Sync for Date<Tz> where
<Tz as TimeZone>::Offset: Sync,
<Tz as TimeZone>::Offset: Sync,
impl<Tz> Unpin for Date<Tz> where
<Tz as TimeZone>::Offset: Unpin,
<Tz as TimeZone>::Offset: Unpin,
impl<Tz> UnwindSafe for Date<Tz> where
<Tz as TimeZone>::Offset: UnwindSafe,
<Tz as TimeZone>::Offset: UnwindSafe,
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,