# Struct time::Duration [−] [src]

    pub struct Duration { /* fields omitted */ }

ISO 8601 time duration with nanosecond precision. This also allows for the negative duration; see individual methods for details.

## Methods

### `impl Duration`
[src]

#### `fn weeks(weeks: i64) -> Duration`

Makes a new `Duration` with given number of weeks. Equivalent to `Duration::seconds(weeks * 7 * 24 * 60 * 60)` with overflow checks. Panics when the duration is out of bounds.

#### `fn days(days: i64) -> Duration`

Makes a new `Duration` with given number of days. Equivalent to `Duration::seconds(days * 24 * 60 * 60)` with overflow checks. Panics when the duration is out of bounds.

#### `fn hours(hours: i64) -> Duration`

Makes a new `Duration` with given number of hours. Equivalent to `Duration::seconds(hours * 60 * 60)` with overflow checks. Panics when the duration is out of bounds.

#### `fn minutes(minutes: i64) -> Duration`

Makes a new `Duration` with given number of minutes. Equivalent to `Duration::seconds(minutes * 60)` with overflow checks. Panics when the duration is out of bounds.

#### `fn seconds(seconds: i64) -> Duration`

Makes a new `Duration` with given number of seconds. Panics when the duration is more than `i64::MAX` milliseconds or less than `i64::MIN` milliseconds.

#### `fn milliseconds(milliseconds: i64) -> Duration`

Makes a new `Duration` with given number of milliseconds.

#### `fn microseconds(microseconds: i64) -> Duration`

Makes a new `Duration` with given number of microseconds.

#### `fn nanoseconds(nanos: i64) -> Duration`

Makes a new `Duration` with given number of nanoseconds.

#### `fn span<F>(f: F) -> Duration where
F: FnOnce(),`

Runs a closure, returning the duration of time it took to run the closure.

#### `fn num_weeks(&self) -> i64`

Returns the total number of whole weeks in the duration.

#### `fn num_days(&self) -> i64`

Returns the total number of whole days in the duration.

#### `fn num_hours(&self) -> i64`

Returns the total number of whole hours in the duration.

#### `fn num_minutes(&self) -> i64`

Returns the total number of whole minutes in the duration.

#### `fn num_seconds(&self) -> i64`

Returns the total number of whole seconds in the duration.

#### `fn num_milliseconds(&self) -> i64`

Returns the total number of whole milliseconds in the duration,

#### `fn num_microseconds(&self) -> Option<i64>`

Returns the total number of whole microseconds in the duration, or `None` on overflow (exceeding 263 microseconds in either direction).

#### `fn num_nanoseconds(&self) -> Option<i64>`

Returns the total number of whole nanoseconds in the duration, or `None` on overflow (exceeding 263 nanoseconds in either direction).

#### `fn checked_add(&self, rhs: &Duration) -> Option<Duration>`

Add two durations, returning `None` if overflow occurred.

#### `fn checked_sub(&self, rhs: &Duration) -> Option<Duration>`

Subtract two durations, returning `None` if overflow occurred.

#### `fn min_value() -> Duration`

The minimum possible `Duration`: `i64::MIN` milliseconds.

#### `fn max_value() -> Duration`

The maximum possible `Duration`: `i64::MAX` milliseconds.

#### `fn zero() -> Duration`

A duration where the stored seconds and nanoseconds are equal to zero.

#### `fn is_zero(&self) -> bool`

Returns `true` if the duration equals `Duration::zero()`.

#### `fn from_std(duration: StdDuration) -> Result<Duration, OutOfRangeError>`

Creates a `time::Duration` object from `std::time::Duration`

This function errors when original duration is larger than the maximum value supported for this type.

#### `fn to_std(&self) -> Result<StdDuration, OutOfRangeError>`

Creates a `std::time::Duration` object from `time::Duration`

This function errors when duration is less than zero. As standard library implementation is limited to non-negative values.

## Trait Implementations

### `impl Clone for Duration`
[src]

#### `fn clone(&self) -> Duration`

Returns a copy of the value. Read more

#### `fn clone_from(&mut self, source: &Self)`
1.0.0

Performs copy-assignment from `source`. Read more

### `impl Copy for Duration`
[src]

### `impl PartialEq for Duration`
[src]

#### `fn eq(&self, __arg_0: &Duration) -> bool`

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

#### `fn ne(&self, __arg_0: &Duration) -> bool`

This method tests for `!=`.

### `impl Eq for Duration`
[src]

### `impl PartialOrd for Duration`
[src]

#### `fn partial_cmp(&self, __arg_0: &Duration) -> Option<Ordering>`

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

#### `fn lt(&self, __arg_0: &Duration) -> bool`

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

#### `fn le(&self, __arg_0: &Duration) -> bool`

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

#### `fn gt(&self, __arg_0: &Duration) -> bool`

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

#### `fn ge(&self, __arg_0: &Duration) -> bool`

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

### `impl Ord for Duration`
[src]

#### `fn cmp(&self, __arg_0: &Duration) -> Ordering`

This method returns an `Ordering` between `self` and `other`. Read more

### `impl Debug for Duration`
[src]

#### `fn fmt(&self, __arg_0: &mut Formatter) -> Result`

Formats the value using the given formatter.

### `impl Neg for Duration`
[src]

#### `type Output = Duration`

The resulting type after applying the `-` operator

#### `fn neg(self) -> Duration`

The method for the unary `-` operator

### `impl Add for Duration`
[src]

#### `type Output = Duration`

The resulting type after applying the `+` operator

#### `fn add(self, rhs: Duration) -> Duration`

The method for the `+` operator

### `impl Sub for Duration`
[src]

#### `type Output = Duration`

The resulting type after applying the `-` operator

#### `fn sub(self, rhs: Duration) -> Duration`

The method for the `-` operator

### `impl Mul<i32> for Duration`
[src]

#### `type Output = Duration`

The resulting type after applying the `*` operator

#### `fn mul(self, rhs: i32) -> Duration`

The method for the `*` operator

### `impl Div<i32> for Duration`
[src]

#### `type Output = Duration`

The resulting type after applying the `/` operator

#### `fn div(self, rhs: i32) -> Duration`

The method for the `/` operator

### `impl Display for Duration`
[src]

#### `fn fmt(&self, f: &mut Formatter) -> Result`

Formats the value using the given formatter. Read more

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)