pub struct TimeUtc {
pub inner: NaiveTime,
}
Fields
inner: NaiveTime
Implementations
Methods from Deref<Target = NaiveTime>
sourcepub fn overflowing_add_signed(&self, rhs: Duration) -> (NaiveTime, i64)
pub fn overflowing_add_signed(&self, rhs: Duration) -> (NaiveTime, i64)
Adds given Duration
to the current time,
and also returns the number of seconds
in the integral number of days ignored from the addition.
(We cannot return Duration
because it is subject to overflow or underflow.)
Example
use chrono::{Duration, NaiveTime};
let from_hms = NaiveTime::from_hms;
assert_eq!(from_hms(3, 4, 5).overflowing_add_signed(Duration::hours(11)),
(from_hms(14, 4, 5), 0));
assert_eq!(from_hms(3, 4, 5).overflowing_add_signed(Duration::hours(23)),
(from_hms(2, 4, 5), 86_400));
assert_eq!(from_hms(3, 4, 5).overflowing_add_signed(Duration::hours(-7)),
(from_hms(20, 4, 5), -86_400));
sourcepub fn overflowing_sub_signed(&self, rhs: Duration) -> (NaiveTime, i64)
pub fn overflowing_sub_signed(&self, rhs: Duration) -> (NaiveTime, i64)
Subtracts given Duration
from the current time,
and also returns the number of seconds
in the integral number of days ignored from the subtraction.
(We cannot return Duration
because it is subject to overflow or underflow.)
Example
use chrono::{Duration, NaiveTime};
let from_hms = NaiveTime::from_hms;
assert_eq!(from_hms(3, 4, 5).overflowing_sub_signed(Duration::hours(2)),
(from_hms(1, 4, 5), 0));
assert_eq!(from_hms(3, 4, 5).overflowing_sub_signed(Duration::hours(17)),
(from_hms(10, 4, 5), 86_400));
assert_eq!(from_hms(3, 4, 5).overflowing_sub_signed(Duration::hours(-22)),
(from_hms(1, 4, 5), -86_400));
sourcepub 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 time with the specified formatting items.
Otherwise it is the same as the ordinary format
method.
The Iterator
of items should be Clone
able,
since the resulting DelayedFormat
value may be formatted multiple times.
Example
use chrono::NaiveTime;
use chrono::format::strftime::StrftimeItems;
let fmt = StrftimeItems::new("%H:%M:%S");
let t = NaiveTime::from_hms(23, 56, 4);
assert_eq!(t.format_with_items(fmt.clone()).to_string(), "23:56:04");
assert_eq!(t.format("%H:%M:%S").to_string(), "23:56:04");
The resulting DelayedFormat
can be formatted directly via the Display
trait.
assert_eq!(format!("{}", t.format_with_items(fmt)), "23:56:04");
sourcepub fn format(&self, fmt: &'a str) -> DelayedFormat<StrftimeItems<'a>>
pub fn format(&self, fmt: &'a str) -> DelayedFormat<StrftimeItems<'a>>
Formats the time with the specified format string.
See the format::strftime
module
on the supported escape sequences.
This returns a DelayedFormat
,
which gets converted to a string only when actual formatting happens.
You may use the to_string
method to get a String
,
or just feed it into print!
and other formatting macros.
(In this way it avoids the redundant memory allocation.)
A wrong format string does not issue an error immediately.
Rather, converting or formatting the DelayedFormat
fails.
You are recommended to immediately use DelayedFormat
for this reason.
Example
use chrono::NaiveTime;
let t = NaiveTime::from_hms_nano(23, 56, 4, 12_345_678);
assert_eq!(t.format("%H:%M:%S").to_string(), "23:56:04");
assert_eq!(t.format("%H:%M:%S%.6f").to_string(), "23:56:04.012345");
assert_eq!(t.format("%-I:%M %p").to_string(), "11:56 PM");
The resulting DelayedFormat
can be formatted directly via the Display
trait.
assert_eq!(format!("{}", t.format("%H:%M:%S")), "23:56:04");
assert_eq!(format!("{}", t.format("%H:%M:%S%.6f")), "23:56:04.012345");
assert_eq!(format!("{}", t.format("%-I:%M %p")), "11:56 PM");
Trait Implementations
sourceimpl<'de> Deserialize<'de> for TimeUtc
impl<'de> Deserialize<'de> for TimeUtc
sourcefn deserialize<D>(
deserializer: D
) -> Result<TimeUtc, <D as Deserializer<'de>>::Error> where
D: Deserializer<'de>,
fn deserialize<D>(
deserializer: D
) -> Result<TimeUtc, <D as Deserializer<'de>>::Error> where
D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
sourceimpl Ord for TimeUtc
impl Ord for TimeUtc
sourceimpl PartialOrd<TimeUtc> for TimeUtc
impl PartialOrd<TimeUtc> for TimeUtc
sourcefn partial_cmp(&self, other: &TimeUtc) -> Option<Ordering>
fn partial_cmp(&self, other: &TimeUtc) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
sourceimpl Serialize for TimeUtc
impl Serialize for TimeUtc
sourcefn serialize<S>(
&self,
serializer: S
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error> where
S: Serializer,
fn serialize<S>(
&self,
serializer: S
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error> where
S: Serializer,
Serialize this value into the given Serde serializer. Read more
impl Copy for TimeUtc
impl Eq for TimeUtc
impl StructuralEq for TimeUtc
impl StructuralPartialEq for TimeUtc
Auto Trait Implementations
impl RefUnwindSafe for TimeUtc
impl Send for TimeUtc
impl Sync for TimeUtc
impl Unpin for TimeUtc
impl UnwindSafe for TimeUtc
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<Q, K> Equivalent<K> for Q where
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Q where
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
sourcefn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
Compare self to key
and return true
if they are equal.
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more