blob: cab15b55b474e4fcfb8121c7eb33962a252c4cc8 [file] [log] [blame]
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="A measurement of a monotonically non-decreasing clock. Opaque and useful only with [`Duration`]."><meta name="keywords" content="rust, rustlang, rust-lang, Instant"><title>Instant in time - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" href="../normalize.css"><link rel="stylesheet" href="../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" href="../ayu.css" disabled><link rel="stylesheet" href="../dark.css" disabled><link rel="stylesheet" href="../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../storage.js"></script><script defer src="sidebar-items.js"></script><script defer src="../main.js"></script><noscript><link rel="stylesheet" href="../noscript.css"></noscript><link rel="icon" href="https://avatars0.githubusercontent.com/u/55999857"></head><body class="rustdoc struct"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">&#9776;</button><a class="sidebar-logo" href="../time/index.html"><div class="logo-container"><img src="https://avatars0.githubusercontent.com/u/55999857" alt="logo"></div></a><h2></h2></nav><nav class="sidebar"><a class="sidebar-logo" href="../time/index.html"><div class="logo-container">
<img src="https://avatars0.githubusercontent.com/u/55999857" alt="logo"></div></a><h2 class="location"><a href="#">Instant</a></h2><div class="sidebar-elems"><section><h3><a href="#fields">Tuple Fields</a></h3><h3><a href="#implementations">Methods</a></h3><ul class="block"><li><a href="#method.checked_add">checked_add</a></li><li><a href="#method.checked_sub">checked_sub</a></li><li><a href="#method.elapsed">elapsed</a></li><li><a href="#method.into_inner">into_inner</a></li><li><a href="#method.now">now</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block"><li><a href="#impl-Add%3CDuration%3E-for-Instant">Add&lt;Duration&gt;</a></li><li><a href="#impl-Add%3CDuration%3E-for-Instant-1">Add&lt;Duration&gt;</a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-Instant">AddAssign&lt;Duration&gt;</a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-Instant-1">AddAssign&lt;Duration&gt;</a></li><li><a href="#impl-AsRef%3CInstant%3E-for-Instant">AsRef&lt;Instant&gt;</a></li><li><a href="#impl-Borrow%3CInstant%3E-for-Instant">Borrow&lt;Instant&gt;</a></li><li><a href="#impl-Clone-for-Instant">Clone</a></li><li><a href="#impl-Copy-for-Instant">Copy</a></li><li><a href="#impl-Debug-for-Instant">Debug</a></li><li><a href="#impl-Eq-for-Instant">Eq</a></li><li><a href="#impl-From%3CInstant%3E-for-Instant">From&lt;Instant&gt;</a></li><li><a href="#impl-From%3CInstant%3E-for-StdInstant">From&lt;Instant&gt;</a></li><li><a href="#impl-Hash-for-Instant">Hash</a></li><li><a href="#impl-Ord-for-Instant">Ord</a></li><li><a href="#impl-PartialEq%3CInstant%3E-for-Instant">PartialEq&lt;Instant&gt;</a></li><li><a href="#impl-PartialEq%3CInstant%3E-for-Instant-1">PartialEq&lt;Instant&gt;</a></li><li><a href="#impl-PartialEq%3CInstant%3E-for-StdInstant">PartialEq&lt;Instant&gt;</a></li><li><a href="#impl-PartialOrd%3CInstant%3E-for-Instant">PartialOrd&lt;Instant&gt;</a></li><li><a href="#impl-PartialOrd%3CInstant%3E-for-Instant-1">PartialOrd&lt;Instant&gt;</a></li><li><a href="#impl-PartialOrd%3CInstant%3E-for-StdInstant">PartialOrd&lt;Instant&gt;</a></li><li><a href="#impl-StructuralEq-for-Instant">StructuralEq</a></li><li><a href="#impl-StructuralPartialEq-for-Instant">StructuralPartialEq</a></li><li><a href="#impl-Sub%3CDuration%3E-for-Instant">Sub&lt;Duration&gt;</a></li><li><a href="#impl-Sub%3CDuration%3E-for-Instant-1">Sub&lt;Duration&gt;</a></li><li><a href="#impl-Sub%3CInstant%3E-for-Instant">Sub&lt;Instant&gt;</a></li><li><a href="#impl-Sub%3CInstant%3E-for-Instant-1">Sub&lt;Instant&gt;</a></li><li><a href="#impl-Sub%3CInstant%3E-for-StdInstant">Sub&lt;Instant&gt;</a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-Instant">SubAssign&lt;Duration&gt;</a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-Instant-1">SubAssign&lt;Duration&gt;</a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block"><li><a href="#impl-RefUnwindSafe-for-Instant">RefUnwindSafe</a></li><li><a href="#impl-Send-for-Instant">Send</a></li><li><a href="#impl-Sync-for-Instant">Sync</a></li><li><a href="#impl-Unpin-for-Instant">Unpin</a></li><li><a href="#impl-UnwindSafe-for-Instant">UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block"><li><a href="#impl-Any-for-Instant">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-Instant">Borrow&lt;T&gt;</a></li><li><a href="#impl-BorrowMut%3CT%3E-for-Instant">BorrowMut&lt;T&gt;</a></li><li><a href="#impl-From%3CT%3E-for-Instant">From&lt;T&gt;</a></li><li><a href="#impl-Into%3CU%3E-for-Instant">Into&lt;U&gt;</a></li><li><a href="#impl-ToOwned-for-Instant">ToOwned</a></li><li><a href="#impl-TryFrom%3CU%3E-for-Instant">TryFrom&lt;U&gt;</a></li><li><a href="#impl-TryInto%3CU%3E-for-Instant">TryInto&lt;U&gt;</a></li></ul></section><h2><a href="index.html">In time</a></h2></div></nav><main><div class="width-limiter"><nav class="sub"><form class="search-form"><div class="search-container"><span></span><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><div id="help-button" title="help" tabindex="-1"><a href="../help.html">?</a></div><div id="settings-menu" tabindex="-1"><a href="../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../wheel.svg"></a></div></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1 class="fqn">Struct <a href="index.html">time</a>::<wbr><a class="struct" href="#">Instant</a><button id="copy-path" onclick="copy_path(this)" title="Copy item path to clipboard"><img src="../clipboard.svg" width="19" height="18" alt="Copy item path"></button></h1><span class="out-of-band"><a class="srclink" href="../src/time/instant.rs.html#30">source</a> · <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">&#x2212;</span>]</a></span></div><div class="item-decl"><pre class="rust struct"><code><div class="code-attribute">#[repr(transparent)]</div>pub struct Instant(pub StdInstant);</code></pre></div><details class="rustdoc-toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>A measurement of a monotonically non-decreasing clock. Opaque and useful only with <a href="struct.Duration.html" title="Duration"><code>Duration</code></a>.</p>
<p>Instants are always guaranteed to be no less than any previously measured instant when created,
and are often useful for tasks such as measuring benchmarks or timing how long an operation
takes.</p>
<p>Note, however, that instants are not guaranteed to be <strong>steady</strong>. In other words, each tick of
the underlying clock may not be the same length (e.g. some seconds may be longer than others).
An instant may jump forwards or experience time dilation (slow down or speed up), but it will
never go backwards.</p>
<p>Instants are opaque types that can only be compared to one another. There is no method to get
“the number of seconds” from an instant. Instead, it only allows measuring the duration between
two instants (or comparing two instants).</p>
<p>This implementation allows for operations with signed <a href="struct.Duration.html" title="Duration"><code>Duration</code></a>s, but is otherwise identical
to [<code>std::time::Instant</code>].</p>
</div></details><h2 id="fields" class="fields small-section-header">Tuple Fields<a href="#fields" class="anchor"></a></h2><span id="structfield.0" class="structfield small-section-header"><a href="#structfield.0" class="anchor field"></a><code>0: StdInstant</code></span><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><div id="implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#32-113">source</a><a href="#impl-Instant" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.now" class="method has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#40-42">source</a><h4 class="code-header">pub fn <a href="#method.now" class="fnname">now</a>() -&gt; Self</h4></section></summary><div class="docblock"><p>Returns an <code>Instant</code> corresponding to “now”.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">println!</span>(<span class="string">&quot;{:?}&quot;</span>, Instant::now());</code></pre><a class="test-arrow" target="_blank" href="https://play.rust-lang.org?code=%23!%5Ballow(unused)%5D%0Aextern%20crate%20r%23time%3B%0Afn%20main()%20%7B%0Ause%20time%3A%3AInstant%3B%0Aprintln!(%22%7B%3A%3F%7D%22%2C%20Instant%3A%3Anow())%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.elapsed" class="method has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#54-56">source</a><h4 class="code-header">pub fn <a href="#method.elapsed" class="fnname">elapsed</a>(self) -&gt; <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a></h4></section></summary><div class="docblock"><p>Returns the amount of time elapsed since this instant was created. The duration will always
be nonnegative if the instant is not synthetically created.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>instant = Instant::now();
thread::sleep(<span class="number">1</span>.std_milliseconds());
<span class="macro">assert!</span>(instant.elapsed() &gt;= <span class="number">1</span>.milliseconds());</code></pre><a class="test-arrow" target="_blank" href="https://play.rust-lang.org?code=%23!%5Ballow(unused)%5D%0Aextern%20crate%20r%23time%3B%0Afn%20main()%20%7B%0Ause%20time%3A%3A%7BInstant%2C%20ext%3A%3A%7BNumericalStdDuration%2C%20NumericalDuration%7D%7D%3B%0Ause%20std%3A%3Athread%3B%0Alet%20instant%20%3D%20Instant%3A%3Anow()%3B%0Athread%3A%3Asleep(1.std_milliseconds())%3B%0Aassert!(instant.elapsed()%20%3E%3D%201.milliseconds())%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.checked_add" class="method has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#70-79">source</a><h4 class="code-header">pub fn <a href="#method.checked_add" class="fnname">checked_add</a>(self, duration: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -&gt; Option&lt;Self&gt;</h4></section></summary><div class="docblock"><p>Returns <code>Some(t)</code> where <code>t</code> is the time <code>self + duration</code> if <code>t</code> can be represented as
<code>Instant</code> (which means it’s inside the bounds of the underlying data structure), <code>None</code>
otherwise.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>now = Instant::now();
<span class="macro">assert_eq!</span>(now.checked_add(<span class="number">5</span>.seconds()), <span class="prelude-val">Some</span>(now + <span class="number">5</span>.seconds()));
<span class="macro">assert_eq!</span>(now.checked_add((-<span class="number">5</span>).seconds()), <span class="prelude-val">Some</span>(now + (-<span class="number">5</span>).seconds()));</code></pre><a class="test-arrow" target="_blank" href="https://play.rust-lang.org?code=%23!%5Ballow(unused)%5D%0Aextern%20crate%20r%23time%3B%0Afn%20main()%20%7B%0Ause%20time%3A%3A%7BInstant%2C%20ext%3A%3ANumericalDuration%7D%3B%0Alet%20now%20%3D%20Instant%3A%3Anow()%3B%0Aassert_eq!(now.checked_add(5.seconds())%2C%20Some(now%20%2B%205.seconds()))%3B%0Aassert_eq!(now.checked_add((-5).seconds())%2C%20Some(now%20%2B%20(-5).seconds()))%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.checked_sub" class="method has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#91-100">source</a><h4 class="code-header">pub fn <a href="#method.checked_sub" class="fnname">checked_sub</a>(self, duration: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -&gt; Option&lt;Self&gt;</h4></section></summary><div class="docblock"><p>Returns <code>Some(t)</code> where <code>t</code> is the time <code>self - duration</code> if <code>t</code> can be represented as
<code>Instant</code> (which means it’s inside the bounds of the underlying data structure), <code>None</code>
otherwise.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>now = Instant::now();
<span class="macro">assert_eq!</span>(now.checked_sub(<span class="number">5</span>.seconds()), <span class="prelude-val">Some</span>(now - <span class="number">5</span>.seconds()));
<span class="macro">assert_eq!</span>(now.checked_sub((-<span class="number">5</span>).seconds()), <span class="prelude-val">Some</span>(now - (-<span class="number">5</span>).seconds()));</code></pre><a class="test-arrow" target="_blank" href="https://play.rust-lang.org?code=%23!%5Ballow(unused)%5D%0Aextern%20crate%20r%23time%3B%0Afn%20main()%20%7B%0Ause%20time%3A%3A%7BInstant%2C%20ext%3A%3ANumericalDuration%7D%3B%0Alet%20now%20%3D%20Instant%3A%3Anow()%3B%0Aassert_eq!(now.checked_sub(5.seconds())%2C%20Some(now%20-%205.seconds()))%3B%0Aassert_eq!(now.checked_sub((-5).seconds())%2C%20Some(now%20-%20(-5).seconds()))%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into_inner" class="method has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#110-112">source</a><h4 class="code-header">pub const fn <a href="#method.into_inner" class="fnname">into_inner</a>(self) -&gt; StdInstant</h4></section></summary><div class="docblock"><p>Obtain the inner [<code>std::time::Instant</code>].</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>now = Instant::now();
<span class="macro">assert_eq!</span>(now.into_inner(), now.<span class="number">0</span>);</code></pre><a class="test-arrow" target="_blank" href="https://play.rust-lang.org?code=%23!%5Ballow(unused)%5D%0Aextern%20crate%20r%23time%3B%0Afn%20main()%20%7B%0Ause%20time%3A%3AInstant%3B%0Alet%20now%20%3D%20Instant%3A%3Anow()%3B%0Aassert_eq!(now.into_inner()%2C%20now.0)%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details></div></details></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Add%3CDuration%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#159-177">source</a><a href="#impl-Add%3CDuration%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl Add&lt;<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.add" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#166-176">source</a><a href="#method.add" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add</a>(self, duration: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -&gt; Self::Output</h4></section></summary><div class="docblock"><h5 id="panics"><a href="#panics">Panics</a></h5>
<p>This function may panic if the resulting point in time cannot be represented by the
underlying data structure.</p>
</div></details><details class="rustdoc-toggle" open><summary><section id="associatedtype.Output-3" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Output-3" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Output</a> = <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Add%3CDuration%3E-for-Instant-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#187-193">source</a><a href="#impl-Add%3CDuration%3E-for-Instant-1" class="anchor"></a><h3 class="code-header">impl Add&lt;Duration&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Output-4" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Output-4" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Output</a> = <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.add-1" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#190-192">source</a><a href="#method.add-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add</a>(self, duration: StdDuration) -&gt; Self::Output</h4></section></summary><div class='docblock'>Performs the <code>+</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-AddAssign%3CDuration%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#195">source</a><a href="#impl-AddAssign%3CDuration%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl AddAssign&lt;<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.add_assign" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#195">source</a><a href="#method.add_assign" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add_assign</a>(&amp;mut self, rhs: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>)</h4></section></summary><div class='docblock'>Performs the <code>+=</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-AddAssign%3CDuration%3E-for-Instant-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#195">source</a><a href="#impl-AddAssign%3CDuration%3E-for-Instant-1" class="anchor"></a><h3 class="code-header">impl AddAssign&lt;Duration&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.add_assign-1" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#195">source</a><a href="#method.add_assign-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add_assign</a>(&amp;mut self, rhs: StdDuration)</h4></section></summary><div class='docblock'>Performs the <code>+=</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-AsRef%3CInstant%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#266-270">source</a><a href="#impl-AsRef%3CInstant%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl AsRef&lt;Instant&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.as_ref" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#267-269">source</a><a href="#method.as_ref" class="anchor"></a><h4 class="code-header">fn <a class="fnname">as_ref</a>(&amp;self) -&gt; &amp;StdInstant</h4></section></summary><div class='docblock'>Converts this type into a shared reference of the (usually inferred) input type.</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Borrow%3CInstant%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#272-276">source</a><a href="#impl-Borrow%3CInstant%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl Borrow&lt;Instant&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#273-275">source</a><a href="#method.borrow" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow</a>(&amp;self) -&gt; &amp;StdInstant</h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Clone-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-Clone-for-Instant" class="anchor"></a><h3 class="code-header">impl Clone for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#method.clone" class="anchor"></a><h4 class="code-header">fn <a class="fnname">clone</a>(&amp;self) -&gt; <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h4></section></summary><div class='docblock'>Returns a copy of the value. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone_from" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.clone_from" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">clone_from</a>(&amp;mut self, source: &amp;Self)</h4></section></summary><div class='docblock'>Performs copy-assignment from <code>source</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Debug-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-Debug-for-Instant" class="anchor"></a><h3 class="code-header">impl Debug for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#method.fmt" class="anchor"></a><h4 class="code-header">fn <a class="fnname">fmt</a>(&amp;self, f: &amp;mut Formatter&lt;'_&gt;) -&gt; Result</h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-From%3CInstant%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#116-120">source</a><a href="#impl-From%3CInstant%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl From&lt;Instant&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#117-119">source</a><a href="#method.from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(instant: StdInstant) -&gt; Self</h4></section></summary><div class='docblock'>Converts to this type from the input type.</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-From%3CInstant%3E-for-StdInstant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#122-126">source</a><a href="#impl-From%3CInstant%3E-for-StdInstant" class="anchor"></a><h3 class="code-header">impl From&lt;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>&gt; for StdInstant</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from-1" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#123-125">source</a><a href="#method.from-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(instant: <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>) -&gt; Self</h4></section></summary><div class='docblock'>Converts to this type from the input type.</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Hash-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-Hash-for-Instant" class="anchor"></a><h3 class="code-header">impl Hash for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.hash" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#method.hash" class="anchor"></a><h4 class="code-header">fn <a class="fnname">hash</a>&lt;__H:&nbsp;Hasher&gt;(&amp;self, state: &amp;mut __H)</h4></section></summary><div class='docblock'>Feeds this value into the given [<code>Hasher</code>]. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.hash_slice" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.3.0">1.3.0</span><a href="#method.hash_slice" class="anchor"></a><h4 class="code-header">fn <a class="fnname">hash_slice</a>&lt;H&gt;(data: &amp;[Self], state: &amp;mut H)<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;H: Hasher,</span></h4></section></summary><div class='docblock'>Feeds a slice of this type into the given [<code>Hasher</code>]. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Ord-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-Ord-for-Instant" class="anchor"></a><h3 class="code-header">impl Ord for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.cmp" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#method.cmp" class="anchor"></a><h4 class="code-header">fn <a class="fnname">cmp</a>(&amp;self, other: &amp;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>) -&gt; Ordering</h4></section></summary><div class='docblock'>This method returns an [<code>Ordering</code>] between <code>self</code> and <code>other</code>. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.max" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.21.0">1.21.0</span><a href="#method.max" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">max</a>(self, other: Self) -&gt; Self</h4></section></summary><div class='docblock'>Compares and returns the maximum of two values. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.min" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.21.0">1.21.0</span><a href="#method.min" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">min</a>(self, other: Self) -&gt; Self</h4></section></summary><div class='docblock'>Compares and returns the minimum of two values. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clamp" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.50.0">1.50.0</span><a href="#method.clamp" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">clamp</a>(self, min: Self, max: Self) -&gt; Self<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: PartialOrd&lt;Self&gt;,</span></h4></section></summary><div class='docblock'>Restrict a value to a certain interval. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialEq%3CInstant%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-PartialEq%3CInstant%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl PartialEq&lt;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.eq" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#method.eq" class="anchor"></a><h4 class="code-header">fn <a class="fnname">eq</a>(&amp;self, other: &amp;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>) -&gt; bool</h4></section></summary><div class='docblock'>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
by <code>==</code>. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ne" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.ne" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">ne</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests for <code>!=</code>. The default implementation is almost always
sufficient, and should not be overridden without very good reason. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialEq%3CInstant%3E-for-Instant-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#242-246">source</a><a href="#impl-PartialEq%3CInstant%3E-for-Instant-1" class="anchor"></a><h3 class="code-header">impl PartialEq&lt;Instant&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.eq-1" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#243-245">source</a><a href="#method.eq-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">eq</a>(&amp;self, rhs: &amp;StdInstant) -&gt; bool</h4></section></summary><div class='docblock'>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
by <code>==</code>. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ne-1" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.ne-1" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">ne</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests for <code>!=</code>. The default implementation is almost always
sufficient, and should not be overridden without very good reason. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialEq%3CInstant%3E-for-StdInstant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#248-252">source</a><a href="#impl-PartialEq%3CInstant%3E-for-StdInstant" class="anchor"></a><h3 class="code-header">impl PartialEq&lt;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>&gt; for StdInstant</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.eq-2" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#249-251">source</a><a href="#method.eq-2" class="anchor"></a><h4 class="code-header">fn <a class="fnname">eq</a>(&amp;self, rhs: &amp;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>) -&gt; bool</h4></section></summary><div class='docblock'>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
by <code>==</code>. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ne-2" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.ne-2" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">ne</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests for <code>!=</code>. The default implementation is almost always
sufficient, and should not be overridden without very good reason. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialOrd%3CInstant%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-PartialOrd%3CInstant%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl PartialOrd&lt;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.partial_cmp" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#method.partial_cmp" class="anchor"></a><h4 class="code-header">fn <a class="fnname">partial_cmp</a>(&amp;self, other: &amp;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>) -&gt; Option&lt;Ordering&gt;</h4></section></summary><div class='docblock'>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.lt" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.lt" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">lt</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code>&lt;</code> operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.le" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.le" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">le</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>&lt;=</code>
operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.gt" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.gt" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">gt</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>&gt;</code> operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ge" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.ge" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">ge</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>&gt;=</code>
operator. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialOrd%3CInstant%3E-for-Instant-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#254-258">source</a><a href="#impl-PartialOrd%3CInstant%3E-for-Instant-1" class="anchor"></a><h3 class="code-header">impl PartialOrd&lt;Instant&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.partial_cmp-1" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#255-257">source</a><a href="#method.partial_cmp-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">partial_cmp</a>(&amp;self, rhs: &amp;StdInstant) -&gt; Option&lt;Ordering&gt;</h4></section></summary><div class='docblock'>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.lt-1" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.lt-1" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">lt</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code>&lt;</code> operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.le-1" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.le-1" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">le</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>&lt;=</code>
operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.gt-1" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.gt-1" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">gt</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>&gt;</code> operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ge-1" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.ge-1" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">ge</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>&gt;=</code>
operator. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialOrd%3CInstant%3E-for-StdInstant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#260-264">source</a><a href="#impl-PartialOrd%3CInstant%3E-for-StdInstant" class="anchor"></a><h3 class="code-header">impl PartialOrd&lt;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>&gt; for StdInstant</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.partial_cmp-2" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#261-263">source</a><a href="#method.partial_cmp-2" class="anchor"></a><h4 class="code-header">fn <a class="fnname">partial_cmp</a>(&amp;self, rhs: &amp;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>) -&gt; Option&lt;Ordering&gt;</h4></section></summary><div class='docblock'>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.lt-2" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.lt-2" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">lt</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code>&lt;</code> operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.le-2" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.le-2" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">le</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>&lt;=</code>
operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.gt-2" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.gt-2" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">gt</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>&gt;</code> operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ge-2" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.ge-2" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">ge</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>&gt;=</code>
operator. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Sub%3CDuration%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#198-216">source</a><a href="#impl-Sub%3CDuration%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl Sub&lt;<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.sub-3" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#205-215">source</a><a href="#method.sub-3" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, duration: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -&gt; Self::Output</h4></section></summary><div class="docblock"><h5 id="panics-1"><a href="#panics-1">Panics</a></h5>
<p>This function may panic if the resulting point in time cannot be represented by the
underlying data structure.</p>
</div></details><details class="rustdoc-toggle" open><summary><section id="associatedtype.Output-5" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Output-5" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Output</a> = <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Sub%3CDuration%3E-for-Instant-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#226-237">source</a><a href="#impl-Sub%3CDuration%3E-for-Instant-1" class="anchor"></a><h3 class="code-header">impl Sub&lt;Duration&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.sub-4" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#233-236">source</a><a href="#method.sub-4" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, duration: StdDuration) -&gt; Self::Output</h4></section></summary><div class="docblock"><h5 id="panics-2"><a href="#panics-2">Panics</a></h5>
<p>This function may panic if the resulting point in time cannot be represented by the
underlying data structure.</p>
</div></details><details class="rustdoc-toggle" open><summary><section id="associatedtype.Output-6" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Output-6" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Output</a> = <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Sub%3CInstant%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#128-141">source</a><a href="#impl-Sub%3CInstant%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl Sub&lt;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Output" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Output" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Output</a> = <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.sub" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#131-140">source</a><a href="#method.sub" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, other: Self) -&gt; Self::Output</h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Sub%3CInstant%3E-for-Instant-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#143-149">source</a><a href="#impl-Sub%3CInstant%3E-for-Instant-1" class="anchor"></a><h3 class="code-header">impl Sub&lt;Instant&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Output-1" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Output-1" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Output</a> = <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.sub-1" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#146-148">source</a><a href="#method.sub-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, other: StdInstant) -&gt; Self::Output</h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Sub%3CInstant%3E-for-StdInstant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#151-157">source</a><a href="#impl-Sub%3CInstant%3E-for-StdInstant" class="anchor"></a><h3 class="code-header">impl Sub&lt;<a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>&gt; for StdInstant</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Output-2" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Output-2" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Output</a> = <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.sub-2" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#154-156">source</a><a href="#method.sub-2" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, other: <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a>) -&gt; Self::Output</h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-SubAssign%3CDuration%3E-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#239">source</a><a href="#impl-SubAssign%3CDuration%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl SubAssign&lt;<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.sub_assign" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#239">source</a><a href="#method.sub_assign" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub_assign</a>(&amp;mut self, rhs: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>)</h4></section></summary><div class='docblock'>Performs the <code>-=</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-SubAssign%3CDuration%3E-for-Instant-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#239">source</a><a href="#impl-SubAssign%3CDuration%3E-for-Instant-1" class="anchor"></a><h3 class="code-header">impl SubAssign&lt;Duration&gt; for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.sub_assign-1" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#239">source</a><a href="#method.sub_assign-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub_assign</a>(&amp;mut self, rhs: StdDuration)</h4></section></summary><div class='docblock'>Performs the <code>-=</code> operation. <a>Read more</a></div></details></div></details><section id="impl-Copy-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-Copy-for-Instant" class="anchor"></a><h3 class="code-header">impl Copy for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section><section id="impl-Eq-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-Eq-for-Instant" class="anchor"></a><h3 class="code-header">impl Eq for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section><section id="impl-StructuralEq-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-StructuralEq-for-Instant" class="anchor"></a><h3 class="code-header">impl StructuralEq for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section><section id="impl-StructuralPartialEq-for-Instant" class="impl has-srclink"><a class="srclink rightside" href="../src/time/instant.rs.html#29">source</a><a href="#impl-StructuralPartialEq-for-Instant" class="anchor"></a><h3 class="code-header">impl StructuralPartialEq for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><section id="impl-RefUnwindSafe-for-Instant" class="impl has-srclink"><a href="#impl-RefUnwindSafe-for-Instant" class="anchor"></a><h3 class="code-header">impl RefUnwindSafe for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section><section id="impl-Send-for-Instant" class="impl has-srclink"><a href="#impl-Send-for-Instant" class="anchor"></a><h3 class="code-header">impl Send for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section><section id="impl-Sync-for-Instant" class="impl has-srclink"><a href="#impl-Sync-for-Instant" class="anchor"></a><h3 class="code-header">impl Sync for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section><section id="impl-Unpin-for-Instant" class="impl has-srclink"><a href="#impl-Unpin-for-Instant" class="anchor"></a><h3 class="code-header">impl Unpin for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section><section id="impl-UnwindSafe-for-Instant" class="impl has-srclink"><a href="#impl-UnwindSafe-for-Instant" class="anchor"></a><h3 class="code-header">impl UnwindSafe for <a class="struct" href="struct.Instant.html" title="struct time::Instant">Instant</a></h3></section></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Any-for-Instant" class="impl has-srclink"><a href="#impl-Any-for-Instant" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; Any for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: 'static + ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl has-srclink"><a href="#method.type_id" class="anchor"></a><h4 class="code-header">fn <a class="fnname">type_id</a>(&amp;self) -&gt; TypeId</h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-Instant" class="impl has-srclink"><a href="#impl-Borrow%3CT%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; Borrow&lt;T&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow-1" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow</a>(&amp;self) -&gt; &amp;T</h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-Instant" class="impl has-srclink"><a href="#impl-BorrowMut%3CT%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; BorrowMut&lt;T&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow_mut" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow_mut</a>(&amp;mut self) -&gt; &amp;mut T</h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-Instant" class="impl has-srclink"><a href="#impl-From%3CT%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; From&lt;T&gt; for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from-2" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.from-2" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(t: T) -&gt; T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-Instant" class="impl has-srclink"><a href="#impl-Into%3CU%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; Into&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: From&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">into</a>(self) -&gt; U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p>
<p>That is, this conversion is whatever the implementation of
<code>[From]&lt;T&gt; for U</code> chooses to do.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-ToOwned-for-Instant" class="impl has-srclink"><a href="#impl-ToOwned-for-Instant" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; ToOwned for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: Clone,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Owned" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Owned" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Owned</a> = T</h4></section></summary><div class='docblock'>The resulting type after obtaining ownership.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_owned" class="method trait-impl has-srclink"><a href="#method.to_owned" class="anchor"></a><h4 class="code-header">fn <a class="fnname">to_owned</a>(&amp;self) -&gt; T</h4></section></summary><div class='docblock'>Creates owned data from borrowed data, usually by cloning. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone_into" class="method trait-impl has-srclink"><a href="#method.clone_into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">clone_into</a>(&amp;self, target: &amp;mut T)</h4></section></summary><div class='docblock'>Uses borrowed data to replace owned data, usually by cloning. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-Instant" class="impl has-srclink"><a href="#impl-TryFrom%3CU%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; TryFrom&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: Into&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-1" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error-1" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Error</a> = Infallible</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_from</a>(value: U) -&gt; Result&lt;T, &lt;T as TryFrom&lt;U&gt;&gt;::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-Instant" class="impl has-srclink"><a href="#impl-TryInto%3CU%3E-for-Instant" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; TryInto&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: TryFrom&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Error</a> = &lt;U as TryFrom&lt;T&gt;&gt;::Error</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_into</a>(self) -&gt; Result&lt;U, &lt;U as TryFrom&lt;T&gt;&gt;::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details></div></section></div></main><div id="rustdoc-vars" data-root-path="../" data-current-crate="time" data-themes="ayu,dark,light" data-resource-suffix="" data-rustdoc-version="1.66.0-nightly (5c8bff74b 2022-10-21)" ></div></body></html>