Stdlib/std.time/Duration

Duration

struct Duration

A duration of time.

Durations are the primitive type for the measurement of time.

A duration can be negative, when the difference is from a later to an earlier instant.

Examples

let d = 5.seconds();
assert_eq d.seconds(), 5.0;

Methods

pub fn operator-:2(self, b: Duration): Duration

Return a - b as Duration object.

let d = 5.seconds();
d - 5.seconds(); // 0 seconds

let d = 1.5.hours() - 30.minutes();
assert_eq d.hours(), 1.0;
assert_eq d.minutes(), 60.0;

pub fn operator+:2(self, b: Duration): Duration

Return a + b as Duration object.

let d = 5.seconds();
d + 5.seconds(); // 10 seconds

let d = 1.5.hours() + 30.minutes();
assert_eq d.hours(), 2.0;
assert_eq d.minutes(), 120.0;

pub fn operator>=:2(self, b: Duration): bool

pub fn operator>:2(self, b: Duration): bool

pub fn operator<=:2(self, b: Duration): bool

pub fn operator<:2(self, b: Duration): bool

pub fn operator!=:2(self, b: Duration): bool

pub fn operator==:2(self, b: Duration): bool

pub fn nanoseconds(self): int

Return int nanoseconds (ns) of Duration object.

let d = 5.5.seconds();
assert_eq d.nanoseconds(), 5500000000;

pub fn microseconds(self): int

Return int microseconds (us) of Duration object.

let d = 5.5.seconds();
assert_eq d.microseconds(), 5500000;

pub fn milliseconds(self): int

Return int milliseconds (ms) of Duration object.

let d = 5.5.seconds();
assert_eq d.seconds(), 5.5;
assert_eq d.milliseconds(), 5500;

pub fn seconds(self): float

Return float seconds (s) of Duration object.

let d = 5.seconds();
assert_eq d.seconds(), 5.0;
assert_eq d.milliseconds(), 5000;
assert_eq d.microseconds(), 5000000;
assert_eq d.nanoseconds(), 5000000000;

pub fn minutes(self): float

Return float minutes (m) of Duration object.

let d = 5.minutes();
assert_eq d.minutes(), 5.0;
assert_eq d.seconds(), 300.0;

pub fn hours(self): float

Return float hours (h) of Duration object.

let d = 5.hours();
assert_eq d.hours(), 5.0;
assert_eq d.minutes(), 300.0;

pub fn days(self): float

Return float days (d) of Duration object.

let d = 2.5.days();
assert_eq d.days(), 2.5;
assert_eq d.hours(), 60.0;

pub fn to_string(self): string

Return string of Duration object.

If the value >= 1s, then return in seconds (s). If the value >= 1ms, then return in milliseconds (ms). If the value >= 1µs, then return in microseconds (µs).

let d = 15.5.minutes();
assert_eq d.to_string(), "930s";

let d = 2.35.seconds();
assert_eq d.to_string(), "2.35s";

let d = 0.25.seconds();
assert_eq d.to_string(), "250ms";

let d = 0.25.milliseconds();
assert_eq d.to_string(), "250µs";

let d = 0.25.microseconds();
assert_eq d.to_string(), "250ns";

pub fn from_seconds(n: float): Duration

Return Duration of float seconds (s).