Struct SystemTime

1.8.0 · Source

pub struct SystemTime(/* private fields */);

Available on crate feature std only.

Expand description

🕘 std A measurement of the system clock.

Re-exported from std::time:: .

A measurement of the system clock, useful for talking to external entities like the file system or other processes.

Distinct from the Instant type, this time measurement is not monotonic. This means that you can save a file to the file system, then save another file to the file system, and the second file has a SystemTime measurement earlier than the first. In other words, an operation that happens after another operation in real time may have an earlier SystemTime!

Consequently, comparing two SystemTime instances to learn about the duration between them returns a Result instead of an infallible Duration to indicate that this sort of time drift may happen and needs to be handled.

Although a SystemTime cannot be directly inspected, the UNIX_EPOCH constant is provided in this module as an anchor in time to learn information about a SystemTime. By calculating the duration from this fixed point in time, a SystemTime can be converted to a human-readable time, or perhaps some other string representation.

The size of a SystemTime struct may vary depending on the target operating system.

A SystemTime does not count leap seconds. SystemTime::now()’s behavior around a leap second is the same as the operating system’s wall clock. The precise behavior near a leap second (e.g. whether the clock appears to run slow or fast, or stop, or jump) depends on platform and configuration, so should not be relied on.

Example:

use std::time::{Duration, SystemTime};
use std::thread::sleep;

fn main() {
   let now = SystemTime::now();

   // we sleep for 2 seconds
   sleep(Duration::new(2, 0));
   match now.elapsed() {
       Ok(elapsed) => {
           // it prints '2'
           println!("{}", elapsed.as_secs());
       }
       Err(e) => {
           // the system clock went backwards!
           println!("Great Scott! {e:?}");
       }
   }
}

§Platform-specific behavior

The precision of SystemTime can depend on the underlying OS-specific time format. For example, on Windows the time is represented in 100 nanosecond intervals whereas Linux can represent nanosecond intervals.

The following system calls are currently being used by now() to find out the current time:

Platform	System call
SGX	`insecure_time` usercall. More information on timekeeping in SGX
UNIX	clock_gettime (Realtime Clock)
Darwin	clock_gettime (Realtime Clock)
VXWorks	clock_gettime (Realtime Clock)
SOLID	`SOLID_RTC_ReadTime`
WASI	__wasi_clock_time_get (Realtime Clock)
Windows	GetSystemTimePreciseAsFileTime / GetSystemTimeAsFileTime

Disclaimer: These system calls might change over time.

Note: mathematical operations like add may panic if the underlying structure cannot represent the new point in time.

Struct SystemTimeCopy item path

§Platform-specific behavior

Implementations§

impl SystemTime

pub const UNIX_EPOCH: SystemTime = UNIX_EPOCH

§Examples

pub fn now() -> SystemTime

§Examples

pub fn duration_since( &self, earlier: SystemTime, ) -> Result<Duration, SystemTimeError> ⓘ

§Examples

pub fn elapsed(&self) -> Result<Duration, SystemTimeError> ⓘ

§Examples

pub fn checked_add(&self, duration: Duration) -> Option<SystemTime> ⓘ

pub fn checked_sub(&self, duration: Duration) -> Option<SystemTime> ⓘ

Trait Implementations§

impl Add<Duration> for SystemTime

fn add(self, dur: Duration) -> SystemTime

§Panics

type Output = SystemTime

impl AddAssign<Duration> for SystemTime

fn add_assign(&mut self, other: Duration)

impl BitSized<128> for SystemTime

const BIT_SIZE: usize = _

const MIN_BYTE_SIZE: usize = _

fn bit_size(&self) -> usize

fn min_byte_size(&self) -> usize

impl Clone for SystemTime

fn clone(&self) -> SystemTime

fn clone_from(&mut self, source: &Self)

impl Debug for SystemTime

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error> ⓘ

impl<'de> Deserialize<'de> for SystemTime

fn deserialize<D>( deserializer: D, ) -> Result<SystemTime, <D as Deserializer<'de>>::Error> ⓘwhere D: Deserializer<'de>,

impl From<Timestamp> for SystemTime

fn from(time: Timestamp) -> SystemTime

impl From<Zoned> for SystemTime

fn from(time: Zoned) -> SystemTime

impl FromPyObject<'_> for SystemTime

fn extract_bound(obj: &Bound<'_, PyAny>) -> Result<SystemTime, PyErr> ⓘ

impl Hash for SystemTime

fn hash<__H>(&self, state: &mut __H)where __H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

impl IntoPy<Py<PyAny>> for SystemTime

fn into_py(self, py: Python<'_>) -> Py<PyAny>

impl<'py> IntoPyObject<'py> for &SystemTime

type Target = PyAny

type Output = Bound<'py, <&SystemTime as IntoPyObject<'py>>::Target>

type Error = PyErr

fn into_pyobject( self, py: Python<'py>, ) -> Result<<&SystemTime as IntoPyObject<'py>>::Output, <&SystemTime as IntoPyObject<'py>>::Error> ⓘ

impl<'py> IntoPyObject<'py> for SystemTime

type Target = PyAny

type Output = Bound<'py, <SystemTime as IntoPyObject<'py>>::Target>

type Error = PyErr

fn into_pyobject( self, py: Python<'py>, ) -> Result<<SystemTime as IntoPyObject<'py>>::Output, <SystemTime as IntoPyObject<'py>>::Error> ⓘ

impl Ord for SystemTime

fn cmp(&self, other: &SystemTime) -> Ordering

fn max(self, other: Self) -> Selfwhere Self: Sized,

fn min(self, other: Self) -> Selfwhere Self: Sized,

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized,

impl PartialEq for SystemTime

fn eq(&self, other: &SystemTime) -> bool

fn ne(&self, other: &Rhs) -> bool

impl PartialOrd for SystemTime

fn partial_cmp(&self, other: &SystemTime) -> Option<Ordering> ⓘ

fn lt(&self, other: &Rhs) -> bool

fn le(&self, other: &Rhs) -> bool

fn gt(&self, other: &Rhs) -> bool

fn ge(&self, other: &Rhs) -> bool

impl Serialize for SystemTime

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error> ⓘwhere S: Serializer,

impl Sub<Duration> for SystemTime

type Output = SystemTime

fn sub(self, dur: Duration) -> SystemTime

impl SubAssign<Duration> for SystemTime

fn sub_assign(&mut self, other: Duration)

impl TimeSource<false> for SystemTime

fn granularity() -> Enum<2, TimeGranularity, Ratio<u32, u32>>

fn now_millis() -> u64

fn now_micros() -> u64

fn now_nanos() -> u64

Struct SystemTime

fn deserialize<D>( deserializer: D, ) -> Result<SystemTime, <D as Deserializer<'de>>::Error> ⓘ
where D: Deserializer<'de>,

fn hash<H>(&self, state: &mut H)
where __H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

fn max(self, other: Self) -> Self
where Self: Sized,

fn min(self, other: Self) -> Self
where Self: Sized,

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error> ⓘ
where S: Serializer,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<T, R> Chain<R> for T
where T: ?Sized,

fn chain<F>(self, f: F) -> R
where F: FnOnce(Self) -> R, Self: Sized,

fn chain_ref<F>(&self, f: F) -> R
where F: FnOnce(&Self) -> R,

fn chain_mut<F>(&mut self, f: F) -> R
where F: FnOnce(&mut Self) -> R,

impl<T> CloneToUninit for T
where T: Clone,

impl<Q, K> Comparable<K> for Q
where Q: Ord + ?Sized, K: Borrow<Q> + ?Sized,

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

impl<T> ExtAny for T
where T: Any + ?Sized,

fn as_any_ref(&self) -> &dyn Any
where Self: Sized,

fn as_any_mut(&mut self) -> &mut dyn Any
where Self: Sized,