Struct alloc_data::prelude::time::SinceStart

pub struct SinceStart { /* private fields */ }

Wrapper around a duration.

This type represents a point in time relative to the start time of the run of the program being profiled, which is a Date (an absolute point in time).

Implementations

impl SinceStart

pub fn zero() -> SinceStart

A duration of 0 nanoseconds.

pub fn one_sec() -> SinceStart

A duration of 1 second.

pub fn from_secs(secs: u64) -> SinceStart

Constructor from an amount of seconds.

pub fn from_nano_timestamp(secs: u64, nanos: u32) -> SinceStart

Constructor from a timestamp in nanos seconds.

pub fn is_zero(&self) -> bool

True if the duration is zero.

pub fn to_lifetime(self) -> Lifetime

Turns itself in a lifetime.

Methods from Deref<Target = Duration>

pub const SECOND: Duration = Duration::from_secs(1)

pub const MILLISECOND: Duration = Duration::from_millis(1)

pub const MICROSECOND: Duration = Duration::from_micros(1)

pub const NANOSECOND: Duration = Duration::from_nanos(1)

pub const ZERO: Duration = Duration::from_nanos(0)

pub const MAX: Duration = Duration::new(u64::MAX, NANOS_PER_SEC - 1)

pub fn is_zero(&self) -> bool

Returns true if this Duration spans no time.

Examples

use std::time::Duration;

assert!(Duration::ZERO.is_zero());
assert!(Duration::new(0, 0).is_zero());
assert!(Duration::from_nanos(0).is_zero());
assert!(Duration::from_secs(0).is_zero());

assert!(!Duration::new(1, 1).is_zero());
assert!(!Duration::from_nanos(1).is_zero());
assert!(!Duration::from_secs(1).is_zero());

pub fn as_secs(&self) -> u64

Returns the number of whole seconds contained by this Duration.

The returned value does not include the fractional (nanosecond) part of the duration, which can be obtained using subsec_nanos.

Examples

use std::time::Duration;

let duration = Duration::new(5, 730023852);
assert_eq!(duration.as_secs(), 5);

To determine the total number of seconds represented by the Duration, use as_secs in combination with subsec_nanos:

use std::time::Duration;

let duration = Duration::new(5, 730023852);

assert_eq!(5.730023852,
           duration.as_secs() as f64
           + duration.subsec_nanos() as f64 * 1e-9);

pub fn subsec_millis(&self) -> u32

Returns the fractional part of this Duration, in whole milliseconds.

This method does not return the length of the duration when represented by milliseconds. The returned number always represents a fractional portion of a second (i.e., it is less than one thousand).

Examples

use std::time::Duration;

let duration = Duration::from_millis(5432);
assert_eq!(duration.as_secs(), 5);
assert_eq!(duration.subsec_millis(), 432);

pub fn subsec_micros(&self) -> u32

Returns the fractional part of this Duration, in whole microseconds.

This method does not return the length of the duration when represented by microseconds. The returned number always represents a fractional portion of a second (i.e., it is less than one million).

Examples

use std::time::Duration;

let duration = Duration::from_micros(1_234_567);
assert_eq!(duration.as_secs(), 1);
assert_eq!(duration.subsec_micros(), 234_567);

pub fn subsec_nanos(&self) -> u32

Returns the fractional part of this Duration, in nanoseconds.

This method does not return the length of the duration when represented by nanoseconds. The returned number always represents a fractional portion of a second (i.e., it is less than one billion).

Examples

use std::time::Duration;

let duration = Duration::from_millis(5010);
assert_eq!(duration.as_secs(), 5);
assert_eq!(duration.subsec_nanos(), 10_000_000);

pub fn as_millis(&self) -> u128

Returns the total number of whole milliseconds contained by this Duration.

Examples

use std::time::Duration;

let duration = Duration::new(5, 730023852);
assert_eq!(duration.as_millis(), 5730);

pub fn as_micros(&self) -> u128

Returns the total number of whole microseconds contained by this Duration.

Examples

use std::time::Duration;

let duration = Duration::new(5, 730023852);
assert_eq!(duration.as_micros(), 5730023);

pub fn as_nanos(&self) -> u128

Returns the total number of nanoseconds contained by this Duration.

Examples

use std::time::Duration;

let duration = Duration::new(5, 730023852);
assert_eq!(duration.as_nanos(), 5730023852);

pub fn as_secs_f64(&self) -> f64

Returns the number of seconds contained by this Duration as f64.

The returned value does include the fractional (nanosecond) part of the duration.

Examples

use std::time::Duration;

let dur = Duration::new(2, 700_000_000);
assert_eq!(dur.as_secs_f64(), 2.7);

pub fn as_secs_f32(&self) -> f32

Returns the number of seconds contained by this Duration as f32.

The returned value does include the fractional (nanosecond) part of the duration.

Examples

use std::time::Duration;

let dur = Duration::new(2, 700_000_000);
assert_eq!(dur.as_secs_f32(), 2.7);

Trait Implementations

impl<'a, 'b> Add<&'a SinceStart> for &'b Date

type Output = Date

The resulting type after applying the + operator.

fn add(
    self,
    duration: &'a SinceStart
) -> <&'b Date as Add<&'a SinceStart>>::Output

Performs the + operation.

impl<'a, 'b> Add<&'a SinceStart> for &'b SinceStart

type Output = SinceStart

The resulting type after applying the + operator.

fn add(self, other: &'a SinceStart) -> SinceStart

Performs the + operation.

impl<'a> Add<&'a SinceStart> for Date

type Output = Date

The resulting type after applying the + operator.

fn add(self, duration: &'a SinceStart) -> <Date as Add<&'a SinceStart>>::Output

Performs the + operation.

impl<'a> Add<&'a SinceStart> for SinceStart

type Output = SinceStart

The resulting type after applying the + operator.

fn add(self, other: &'a SinceStart) -> SinceStart

Performs the + operation.

impl<'a> Add<SinceStart> for &'a Date

type Output = Date

The resulting type after applying the + operator.

fn add(self, duration: SinceStart) -> <&'a Date as Add<SinceStart>>::Output

Performs the + operation.

impl<'a> Add<SinceStart> for &'a SinceStart

type Output = SinceStart

The resulting type after applying the + operator.

fn add(self, other: SinceStart) -> SinceStart

Performs the + operation.

impl Add<SinceStart> for Date

Adds a duration.

Examples

use base::prelude::time::*;
let (secs, subsec_nanos) = (1_566_489_242, 7_000_572);
let mut date = Date::from_timestamp(secs, subsec_nanos);
let duration = SinceStart::parse_secs("7.003000001").unwrap();
date = date + duration;
assert_eq! { date.timestamp(), (secs + 7, subsec_nanos + 3_000_001) }

type Output = Date

The resulting type after applying the + operator.

fn add(self, duration: SinceStart) -> <Date as Add<SinceStart>>::Output

Performs the + operation.

impl Add<SinceStart> for SinceStart

type Output = SinceStart

The resulting type after applying the + operator.

fn add(self, other: SinceStart) -> SinceStart

Performs the + operation.

impl Clone for SinceStart

fn clone(&self) -> SinceStart

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SinceStart

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

Formats the value using the given formatter.

impl Deref for SinceStart

type Target = Duration

The resulting type after dereferencing.

fn deref(&self) -> &Duration

Dereferences the value.

impl<'de> Deserialize<'de> for SinceStart

fn deserialize<__D>(
    __deserializer: __D
) -> Result<SinceStart, <__D as Deserializer<'de>>::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for SinceStart

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

Formats the value using the given formatter.

impl<'a> Div<u32> for &'a SinceStart

type Output = SinceStart

The resulting type after applying the / operator.

fn div(self, ratio: u32) -> SinceStart

Performs the / operation.

impl Div<u32> for SinceStart

type Output = SinceStart

The resulting type after applying the / operator.

fn div(self, ratio: u32) -> SinceStart

Performs the / operation.

impl DurationExt for SinceStart

fn as_duration(&self) -> &Duration

Retrieves the duration from Self.

fn to_chrono_duration(&self) -> Duration

Retrieves the chrono duration from Self.

fn from_micros(ts: u64) -> Self

Creates a duration from a timestamp in microseconds.

fn parse_secs<Str>(ts: &Str) -> Result<Self, Error> where
    Str: AsRef<str> + ?Sized, 

Duration parser from an amount of seconds, seen as a float.

fn display_millis(&'me self) -> DurationDisplay<'me, Self, Millis>

Pretty displayable version of a duration, millisecond precision.

fn display_micros(&'me self) -> DurationDisplay<'me, Self, Micros>

Pretty displayable version of a duration, microsecond precision.

fn display_nanos(&'me self) -> DurationDisplay<'me, Self, Nanos>

Pretty displayable version of a duration, nanosecond precision.

impl From<Duration> for SinceStart

fn from(duration: Duration) -> SinceStart

Converts to this type from the input type.

impl Hash for SinceStart

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl Into<Duration> for SinceStart

fn into(self) -> Duration

Converts this type into the (usually inferred) input type.

impl Ord for SinceStart

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl Parseable for SinceStart

type Info = ()

Information used during parsing.

fn parse_with(text: impl AsRef<str>, _info: &Self::Info) -> Res<Self>

Parses something, given some info.

fn parse(text: impl AsRef<str>) -> Res<Self> where
    Self: Parseable<Info = ()>, 

Parses something when no info is needed.

impl PartialEq<SinceStart> for SinceStart

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<SinceStart> for SinceStart

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

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for SinceStart

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.

impl<'a, 'b> Sub<&'a SinceStart> for &'b SinceStart

type Output = SinceStart

The resulting type after applying the - operator.

fn sub(self, other: &'a SinceStart) -> SinceStart

Performs the - operation.

impl<'a> Sub<&'a SinceStart> for Date

type Output = Date

The resulting type after applying the - operator.

fn sub(self, duration: &'a SinceStart) -> <Date as Sub<&'a SinceStart>>::Output

Performs the - operation.

impl<'a> Sub<&'a SinceStart> for SinceStart

type Output = SinceStart

The resulting type after applying the - operator.

fn sub(self, other: &'a SinceStart) -> SinceStart

Performs the - operation.

impl<'a, 'b> Sub<&'b SinceStart> for &'a Date

type Output = Date

The resulting type after applying the - operator.

fn sub(
    self,
    duration: &'b SinceStart
) -> <&'a Date as Sub<&'b SinceStart>>::Output

Performs the - operation.

impl<'a> Sub<SinceStart> for &'a Date

type Output = Date

The resulting type after applying the - operator.

fn sub(self, duration: SinceStart) -> <&'a Date as Sub<SinceStart>>::Output

Performs the - operation.

impl<'a> Sub<SinceStart> for &'a SinceStart

type Output = SinceStart

The resulting type after applying the - operator.

fn sub(self, other: SinceStart) -> SinceStart

Performs the - operation.

impl Sub<SinceStart> for Date

type Output = Date

The resulting type after applying the - operator.

fn sub(self, duration: SinceStart) -> <Date as Sub<SinceStart>>::Output

Performs the - operation.

impl Sub<SinceStart> for SinceStart

type Output = SinceStart

The resulting type after applying the - operator.

fn sub(self, other: SinceStart) -> SinceStart

Performs the - operation.

impl Copy for SinceStart

impl Eq for SinceStart

impl StructuralEq for SinceStart

impl StructuralPartialEq for SinceStart