pub struct Timestamp(/* private fields */);
Expand description
A wrapper for SystemTime that has FromStr
implementation
This is useful if you want to use it somewhere where FromStr
is
expected.
See parse_rfc3339_weak
for the description of the format. The “weak”
format is used as it’s more pemissive for human input as this is the
expected use of the type (e.g. command-line parsing).
§Example
use std::time::SystemTime;
let x: SystemTime;
x = "2018-02-16T00:31:37Z".parse::<humantime::Timestamp>().unwrap().into();
assert_eq!(humantime::format_rfc3339(x).to_string(), "2018-02-16T00:31:37Z");
Methods from Deref<Target = SystemTime>§
pub const UNIX_EPOCH: SystemTime = UNIX_EPOCH
1.8.0 · sourcepub fn duration_since(
&self,
earlier: SystemTime,
) -> Result<Duration, SystemTimeError>
pub fn duration_since( &self, earlier: SystemTime, ) -> Result<Duration, SystemTimeError>
Returns the amount of time elapsed from an earlier point in time.
This function may fail because measurements taken earlier are not
guaranteed to always be before later measurements (due to anomalies such
as the system clock being adjusted either forwards or backwards).
Instant
can be used to measure elapsed time without this risk of failure.
If successful, Ok(Duration)
is returned where the duration represents
the amount of time elapsed from the specified measurement to this one.
Returns an Err
if earlier
is later than self
, and the error
contains how far from self
the time is.
§Examples
use std::time::SystemTime;
let sys_time = SystemTime::now();
let new_sys_time = SystemTime::now();
let difference = new_sys_time.duration_since(sys_time)
.expect("Clock may have gone backwards");
println!("{difference:?}");
1.8.0 · sourcepub fn elapsed(&self) -> Result<Duration, SystemTimeError>
pub fn elapsed(&self) -> Result<Duration, SystemTimeError>
Returns the difference from this system time to the current clock time.
This function may fail as the underlying system clock is susceptible to
drift and updates (e.g., the system clock could go backwards), so this
function might not always succeed. If successful, Ok(Duration)
is
returned where the duration represents the amount of time elapsed from
this time measurement to the current time.
To measure elapsed time reliably, use Instant
instead.
Returns an Err
if self
is later than the current system time, and
the error contains how far from the current system time self
is.
§Examples
use std::thread::sleep;
use std::time::{Duration, SystemTime};
let sys_time = SystemTime::now();
let one_sec = Duration::from_secs(1);
sleep(one_sec);
assert!(sys_time.elapsed().unwrap() >= one_sec);
1.34.0 · sourcepub fn checked_add(&self, duration: Duration) -> Option<SystemTime>
pub fn checked_add(&self, duration: Duration) -> Option<SystemTime>
Returns Some(t)
where t
is the time self + duration
if t
can be represented as
SystemTime
(which means it’s inside the bounds of the underlying data structure), None
otherwise.
1.34.0 · sourcepub fn checked_sub(&self, duration: Duration) -> Option<SystemTime>
pub fn checked_sub(&self, duration: Duration) -> Option<SystemTime>
Returns Some(t)
where t
is the time self - duration
if t
can be represented as
SystemTime
(which means it’s inside the bounds of the underlying data structure), None
otherwise.
Trait Implementations§
source§impl AsRef<SystemTime> for Timestamp
impl AsRef<SystemTime> for Timestamp
source§fn as_ref(&self) -> &SystemTime
fn as_ref(&self) -> &SystemTime
source§impl Deref for Timestamp
impl Deref for Timestamp
§type Target = SystemTime
type Target = SystemTime
source§fn deref(&self) -> &SystemTime
fn deref(&self) -> &SystemTime
source§impl From<SystemTime> for Timestamp
impl From<SystemTime> for Timestamp
source§fn from(dur: SystemTime) -> Timestamp
fn from(dur: SystemTime) -> Timestamp
source§impl Into<SystemTime> for Timestamp
impl Into<SystemTime> for Timestamp
source§fn into(self) -> SystemTime
fn into(self) -> SystemTime
source§impl PartialEq for Timestamp
impl PartialEq for Timestamp
impl Eq for Timestamp
impl StructuralPartialEq for Timestamp
Auto Trait Implementations§
impl Freeze for Timestamp
impl RefUnwindSafe for Timestamp
impl Send for Timestamp
impl Sync for Timestamp
impl Unpin for Timestamp
impl UnwindSafe for Timestamp
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)