| <!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 [`PrimitiveDateTime`] with a [`UtcOffset`]."><meta name="keywords" content="rust, rustlang, rust-lang, OffsetDateTime"><title>OffsetDateTime 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">☰</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="#">OffsetDateTime</a></h2><div class="sidebar-elems"><section><h3><a href="#implementations">Associated Constants</a></h3><ul class="block"><li><a href="#associatedconstant.UNIX_EPOCH">UNIX_EPOCH</a></li></ul><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.date">date</a></li><li><a href="#method.day">day</a></li><li><a href="#method.format">format</a></li><li><a href="#method.format_into">format_into</a></li><li><a href="#method.from_unix_timestamp">from_unix_timestamp</a></li><li><a href="#method.from_unix_timestamp_nanos">from_unix_timestamp_nanos</a></li><li><a href="#method.hour">hour</a></li><li><a href="#method.iso_week">iso_week</a></li><li><a href="#method.microsecond">microsecond</a></li><li><a href="#method.millisecond">millisecond</a></li><li><a href="#method.minute">minute</a></li><li><a href="#method.monday_based_week">monday_based_week</a></li><li><a href="#method.month">month</a></li><li><a href="#method.nanosecond">nanosecond</a></li><li><a href="#method.now_utc">now_utc</a></li><li><a href="#method.offset">offset</a></li><li><a href="#method.ordinal">ordinal</a></li><li><a href="#method.parse">parse</a></li><li><a href="#method.replace_date">replace_date</a></li><li><a href="#method.replace_date_time">replace_date_time</a></li><li><a href="#method.replace_day">replace_day</a></li><li><a href="#method.replace_hour">replace_hour</a></li><li><a href="#method.replace_microsecond">replace_microsecond</a></li><li><a href="#method.replace_millisecond">replace_millisecond</a></li><li><a href="#method.replace_minute">replace_minute</a></li><li><a href="#method.replace_month">replace_month</a></li><li><a href="#method.replace_nanosecond">replace_nanosecond</a></li><li><a href="#method.replace_offset">replace_offset</a></li><li><a href="#method.replace_second">replace_second</a></li><li><a href="#method.replace_time">replace_time</a></li><li><a href="#method.replace_year">replace_year</a></li><li><a href="#method.saturating_add">saturating_add</a></li><li><a href="#method.saturating_sub">saturating_sub</a></li><li><a href="#method.second">second</a></li><li><a href="#method.sunday_based_week">sunday_based_week</a></li><li><a href="#method.time">time</a></li><li><a href="#method.to_calendar_date">to_calendar_date</a></li><li><a href="#method.to_hms">to_hms</a></li><li><a href="#method.to_hms_micro">to_hms_micro</a></li><li><a href="#method.to_hms_milli">to_hms_milli</a></li><li><a href="#method.to_hms_nano">to_hms_nano</a></li><li><a href="#method.to_iso_week_date">to_iso_week_date</a></li><li><a href="#method.to_julian_day">to_julian_day</a></li><li><a href="#method.to_offset">to_offset</a></li><li><a href="#method.to_ordinal_date">to_ordinal_date</a></li><li><a href="#method.unix_timestamp">unix_timestamp</a></li><li><a href="#method.unix_timestamp_nanos">unix_timestamp_nanos</a></li><li><a href="#method.weekday">weekday</a></li><li><a href="#method.year">year</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block"><li><a href="#impl-Add%3CDuration%3E-for-OffsetDateTime">Add<Duration></a></li><li><a href="#impl-Add%3CDuration%3E-for-OffsetDateTime-1">Add<Duration></a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-OffsetDateTime">AddAssign<Duration></a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-OffsetDateTime-1">AddAssign<Duration></a></li><li><a href="#impl-Clone-for-OffsetDateTime">Clone</a></li><li><a href="#impl-Copy-for-OffsetDateTime">Copy</a></li><li><a href="#impl-Debug-for-OffsetDateTime">Debug</a></li><li><a href="#impl-Deserialize%3C%27a%3E-for-OffsetDateTime">Deserialize<'a></a></li><li><a href="#impl-Display-for-OffsetDateTime">Display</a></li><li><a href="#impl-Eq-for-OffsetDateTime">Eq</a></li><li><a href="#impl-From%3COffsetDateTime%3E-for-SystemTime">From<OffsetDateTime></a></li><li><a href="#impl-From%3CSystemTime%3E-for-OffsetDateTime">From<SystemTime></a></li><li><a href="#impl-Hash-for-OffsetDateTime">Hash</a></li><li><a href="#impl-Ord-for-OffsetDateTime">Ord</a></li><li><a href="#impl-PartialEq%3COffsetDateTime%3E-for-OffsetDateTime">PartialEq<OffsetDateTime></a></li><li><a href="#impl-PartialEq%3COffsetDateTime%3E-for-SystemTime">PartialEq<OffsetDateTime></a></li><li><a href="#impl-PartialEq%3CSystemTime%3E-for-OffsetDateTime">PartialEq<SystemTime></a></li><li><a href="#impl-PartialOrd%3COffsetDateTime%3E-for-OffsetDateTime">PartialOrd<OffsetDateTime></a></li><li><a href="#impl-PartialOrd%3COffsetDateTime%3E-for-SystemTime">PartialOrd<OffsetDateTime></a></li><li><a href="#impl-PartialOrd%3CSystemTime%3E-for-OffsetDateTime">PartialOrd<SystemTime></a></li><li><a href="#impl-Serialize-for-OffsetDateTime">Serialize</a></li><li><a href="#impl-StructuralEq-for-OffsetDateTime">StructuralEq</a></li><li><a href="#impl-StructuralPartialEq-for-OffsetDateTime">StructuralPartialEq</a></li><li><a href="#impl-Sub%3CDuration%3E-for-OffsetDateTime">Sub<Duration></a></li><li><a href="#impl-Sub%3CDuration%3E-for-OffsetDateTime-1">Sub<Duration></a></li><li><a href="#impl-Sub%3COffsetDateTime%3E-for-OffsetDateTime">Sub<OffsetDateTime></a></li><li><a href="#impl-Sub%3COffsetDateTime%3E-for-SystemTime">Sub<OffsetDateTime></a></li><li><a href="#impl-Sub%3CSystemTime%3E-for-OffsetDateTime">Sub<SystemTime></a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-OffsetDateTime">SubAssign<Duration></a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-OffsetDateTime-1">SubAssign<Duration></a></li><li><a href="#impl-TryFrom%3CParsed%3E-for-OffsetDateTime">TryFrom<Parsed></a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block"><li><a href="#impl-RefUnwindSafe-for-OffsetDateTime">RefUnwindSafe</a></li><li><a href="#impl-Send-for-OffsetDateTime">Send</a></li><li><a href="#impl-Sync-for-OffsetDateTime">Sync</a></li><li><a href="#impl-Unpin-for-OffsetDateTime">Unpin</a></li><li><a href="#impl-UnwindSafe-for-OffsetDateTime">UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block"><li><a href="#impl-Any-for-OffsetDateTime">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-OffsetDateTime">Borrow<T></a></li><li><a href="#impl-BorrowMut%3CT%3E-for-OffsetDateTime">BorrowMut<T></a></li><li><a href="#impl-DeserializeOwned-for-OffsetDateTime">DeserializeOwned</a></li><li><a href="#impl-From%3CT%3E-for-OffsetDateTime">From<T></a></li><li><a href="#impl-Into%3CU%3E-for-OffsetDateTime">Into<U></a></li><li><a href="#impl-ToOwned-for-OffsetDateTime">ToOwned</a></li><li><a href="#impl-ToString-for-OffsetDateTime">ToString</a></li><li><a href="#impl-TryFrom%3CU%3E-for-OffsetDateTime">TryFrom<U></a></li><li><a href="#impl-TryInto%3CU%3E-for-OffsetDateTime">TryInto<U></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="#">OffsetDateTime</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/offset_date_time.rs.html#30">source</a> · <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span></div><div class="item-decl"><pre class="rust struct"><code>pub struct OffsetDateTime(_);</code></pre></div><details class="rustdoc-toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>A <a href="struct.PrimitiveDateTime.html" title="PrimitiveDateTime"><code>PrimitiveDateTime</code></a> with a <a href="struct.UtcOffset.html" title="UtcOffset"><code>UtcOffset</code></a>.</p> |
| <p>All comparisons are performed using the UTC time.</p> |
| </div></details><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-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#32-735">source</a><a href="#impl-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedconstant.UNIX_EPOCH" class="associatedconstant has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#40">source</a><h4 class="code-header">pub const <a href="#associatedconstant.UNIX_EPOCH" class="constant">UNIX_EPOCH</a>: Self = _</h4></section></summary><div class="docblock"><p>Midnight, 1 January, 1970 (UTC).</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(OffsetDateTime::UNIX_EPOCH, <span class="macro">datetime!</span>(<span class="number">1970</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC),);</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%3AOffsetDateTime%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Aassert_eq!(OffsetDateTime%3A%3AUNIX_EPOCH%2C%20datetime!(1970-01-01%200%3A00%20UTC)%2C)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.now_utc" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#52-54">source</a><h4 class="code-header">pub fn <a href="#method.now_utc" class="fnname">now_utc</a>() -> Self</h4></section></summary><div class="docblock"><p>Create a new <code>OffsetDateTime</code> with the current date and time in UTC.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(OffsetDateTime::now_utc().year() >= <span class="number">2019</span>); |
| <span class="macro">assert_eq!</span>(OffsetDateTime::now_utc().offset(), <span class="macro">offset!</span>(UTC));</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%3AOffsetDateTime%3B%0Ause%20time_macros%3A%3Aoffset%3B%0Aassert!(OffsetDateTime%3A%3Anow_utc().year()%20%3E%3D%202019)%3B%0Aassert_eq!(OffsetDateTime%3A%3Anow_utc().offset()%2C%20offset!(UTC))%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_offset" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#96-98">source</a><h4 class="code-header">pub const fn <a href="#method.to_offset" class="fnname">to_offset</a>(self, offset: <a class="struct" href="struct.UtcOffset.html" title="struct time::UtcOffset">UtcOffset</a>) -> Self</h4></section></summary><div class="docblock"><p>Convert the <code>OffsetDateTime</code> from the current <a href="struct.UtcOffset.html" title="UtcOffset"><code>UtcOffset</code></a> to the provided <a href="struct.UtcOffset.html" title="UtcOffset"><code>UtcOffset</code></a>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2000</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(-<span class="number">1</span>)) |
| .year(), |
| <span class="number">1999</span>, |
| ); |
| |
| <span class="comment">// Let's see what time Sydney's new year's celebration is in New York and Los Angeles. |
| |
| // Construct midnight on new year's in Sydney. |
| </span><span class="kw">let </span>sydney = <span class="macro">datetime!</span>(<span class="number">2000</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>+<span class="number">11</span>); |
| <span class="kw">let </span>new_york = sydney.to_offset(<span class="macro">offset!</span>(-<span class="number">5</span>)); |
| <span class="kw">let </span>los_angeles = sydney.to_offset(<span class="macro">offset!</span>(-<span class="number">8</span>)); |
| <span class="macro">assert_eq!</span>(sydney.hour(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>(new_york.hour(), <span class="number">8</span>); |
| <span class="macro">assert_eq!</span>(los_angeles.hour(), <span class="number">5</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2000-01-01%200%3A00%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(-1))%0A%20%20%20%20%20%20%20%20.year()%2C%0A%20%20%20%201999%2C%0A)%3B%0A%0A%2F%2F%20Let's%20see%20what%20time%20Sydney's%20new%20year's%20celebration%20is%20in%20New%20York%20and%20Los%20Angeles.%0A%0A%2F%2F%20Construct%20midnight%20on%20new%20year's%20in%20Sydney.%0Alet%20sydney%20%3D%20datetime!(2000-01-01%200%3A00%20%2B11)%3B%0Alet%20new_york%20%3D%20sydney.to_offset(offset!(-5))%3B%0Alet%20los_angeles%20%3D%20sydney.to_offset(offset!(-8))%3B%0Aassert_eq!(sydney.hour()%2C%200)%3B%0Aassert_eq!(new_york.hour()%2C%208)%3B%0Aassert_eq!(los_angeles.hour()%2C%205)%3B%0A%7D&edition=2021">Run</a></div> |
| <h5 id="panics"><a href="#panics">Panics</a></h5> |
| <p>This method panics if the local date-time in the new offset is outside the supported range.</p> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from_unix_timestamp" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#129-131">source</a><h4 class="code-header">pub const fn <a href="#method.from_unix_timestamp" class="fnname">from_unix_timestamp</a>(timestamp: i64) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Create an <code>OffsetDateTime</code> from the provided Unix timestamp. Calling <code>.offset()</code> on the |
| resulting value is guaranteed to return UTC.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| OffsetDateTime::from_unix_timestamp(<span class="number">0</span>), |
| <span class="prelude-val">Ok</span>(OffsetDateTime::UNIX_EPOCH), |
| ); |
| <span class="macro">assert_eq!</span>( |
| OffsetDateTime::from_unix_timestamp(<span class="number">1_546_300_800</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC)), |
| );</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%3AOffsetDateTime%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20OffsetDateTime%3A%3Afrom_unix_timestamp(0)%2C%0A%20%20%20%20Ok(OffsetDateTime%3A%3AUNIX_EPOCH)%2C%0A)%3B%0Aassert_eq!(%0A%20%20%20%20OffsetDateTime%3A%3Afrom_unix_timestamp(1_546_300_800)%2C%0A%20%20%20%20Ok(datetime!(2019-01-01%200%3A00%20UTC))%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| <p>If you have a timestamp-nanosecond pair, you can use something along the lines of the |
| following:</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>(timestamp, nanos) = (<span class="number">1</span>, <span class="number">500_000_000</span>); |
| <span class="macro">assert_eq!</span>( |
| OffsetDateTime::from_unix_timestamp(timestamp)<span class="question-mark">? </span>+ Duration::nanoseconds(nanos), |
| OffsetDateTime::UNIX_EPOCH + <span class="number">1.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%20fn%20_inner()%20-%3E%20Result%3C()%2C%20impl%20core%3A%3Afmt%3A%3ADebug%3E%20%7B%0Ause%20time%3A%3A%7BDuration%2C%20OffsetDateTime%2C%20ext%3A%3ANumericalDuration%7D%3B%0Alet%20(timestamp%2C%20nanos)%20%3D%20(1%2C%20500_000_000)%3B%0Aassert_eq!(%0A%20%20%20%20OffsetDateTime%3A%3Afrom_unix_timestamp(timestamp)%3F%20%2B%20Duration%3A%3Ananoseconds(nanos)%2C%0A%20%20%20%20OffsetDateTime%3A%3AUNIX_EPOCH%20%2B%201.5.seconds()%0A)%3B%0AOk%3A%3A%3C_%2C%20time%3A%3AError%3E(())%0A%7D%20_inner().unwrap()%20%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from_unix_timestamp_nanos" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#148-152">source</a><h4 class="code-header">pub const fn <a href="#method.from_unix_timestamp_nanos" class="fnname">from_unix_timestamp_nanos</a>(<br> timestamp: i128<br>) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Construct an <code>OffsetDateTime</code> from the provided Unix timestamp (in nanoseconds). Calling |
| <code>.offset()</code> on the resulting value is guaranteed to return UTC.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| OffsetDateTime::from_unix_timestamp_nanos(<span class="number">0</span>), |
| <span class="prelude-val">Ok</span>(OffsetDateTime::UNIX_EPOCH), |
| ); |
| <span class="macro">assert_eq!</span>( |
| OffsetDateTime::from_unix_timestamp_nanos(<span class="number">1_546_300_800_000_000_000</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC)), |
| );</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%3AOffsetDateTime%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20OffsetDateTime%3A%3Afrom_unix_timestamp_nanos(0)%2C%0A%20%20%20%20Ok(OffsetDateTime%3A%3AUNIX_EPOCH)%2C%0A)%3B%0Aassert_eq!(%0A%20%20%20%20OffsetDateTime%3A%3Afrom_unix_timestamp_nanos(1_546_300_800_000_000_000)%2C%0A%20%20%20%20Ok(datetime!(2019-01-01%200%3A00%20UTC))%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.offset" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#163-165">source</a><h4 class="code-header">pub const fn <a href="#method.offset" class="fnname">offset</a>(self) -> <a class="struct" href="struct.UtcOffset.html" title="struct time::UtcOffset">UtcOffset</a></h4></section></summary><div class="docblock"><p>Get the <a href="struct.UtcOffset.html" title="UtcOffset"><code>UtcOffset</code></a>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).offset(), <span class="macro">offset!</span>(UTC)); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>+<span class="number">1</span>).offset(), <span class="macro">offset!</span>(+<span class="number">1</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).offset()%2C%20offset!(UTC))%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20%2B1).offset()%2C%20offset!(%2B1))%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.unix_timestamp" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#174-176">source</a><h4 class="code-header">pub const fn <a href="#method.unix_timestamp" class="fnname">unix_timestamp</a>(self) -> i64</h4></section></summary><div class="docblock"><p>Get the <a href="https://en.wikipedia.org/wiki/Unix_time">Unix timestamp</a>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">1970</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).unix_timestamp(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">1970</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>-<span class="number">1</span>).unix_timestamp(), <span class="number">3_600</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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(1970-01-01%200%3A00%20UTC).unix_timestamp()%2C%200)%3B%0Aassert_eq!(datetime!(1970-01-01%200%3A00%20-1).unix_timestamp()%2C%203_600)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.unix_timestamp_nanos" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#188-190">source</a><h4 class="code-header">pub const fn <a href="#method.unix_timestamp_nanos" class="fnname">unix_timestamp_nanos</a>(self) -> i128</h4></section></summary><div class="docblock"><p>Get the Unix timestamp in nanoseconds.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>time_macros::datetime; |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">1970</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).unix_timestamp_nanos(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">1970</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>-<span class="number">1</span>).unix_timestamp_nanos(), |
| <span class="number">3_600_000_000_000</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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(1970-01-01%200%3A00%20UTC).unix_timestamp_nanos()%2C%200)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(1970-01-01%200%3A00%20-1).unix_timestamp_nanos()%2C%0A%20%20%20%203_600_000_000_000%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.date" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#204-206">source</a><h4 class="code-header">pub const fn <a href="#method.date" class="fnname">date</a>(self) -> <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h4></section></summary><div class="docblock"><p>Get the <a href="struct.Date.html" title="Date"><code>Date</code></a> in the stored offset.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).date(), <span class="macro">date!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01</span>)); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(-<span class="number">1</span>)) |
| .date(), |
| <span class="macro">date!</span>(<span class="number">2018</span>-<span class="number">12</span>-<span class="number">31</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_macros%3A%3A%7Bdate%2C%20datetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).date()%2C%20date!(2019-01-01))%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%200%3A00%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(-1))%0A%20%20%20%20%20%20%20%20.date()%2C%0A%20%20%20%20date!(2018-12-31)%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.time" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#220-222">source</a><h4 class="code-header">pub const fn <a href="#method.time" class="fnname">time</a>(self) -> <a class="struct" href="struct.Time.html" title="struct time::Time">Time</a></h4></section></summary><div class="docblock"><p>Get the <a href="struct.Time.html" title="Time"><code>Time</code></a> in the stored offset.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).time(), <span class="macro">time!</span>(<span class="number">0</span>:<span class="number">00</span>)); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(-<span class="number">1</span>)) |
| .time(), |
| <span class="macro">time!</span>(<span class="number">23</span>:<span class="number">00</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_macros%3A%3A%7Bdatetime%2C%20offset%2C%20time%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).time()%2C%20time!(0%3A00))%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%200%3A00%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(-1))%0A%20%20%20%20%20%20%20%20.time()%2C%0A%20%20%20%20time!(23%3A00)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.year" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#238-240">source</a><h4 class="code-header">pub const fn <a href="#method.year" class="fnname">year</a>(self) -> i32</h4></section></summary><div class="docblock"><p>Get the year of the date in the stored offset.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).year(), <span class="number">2019</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">12</span>-<span class="number">31 23</span>:<span class="number">00 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(+<span class="number">1</span>)) |
| .year(), |
| <span class="number">2020</span>, |
| ); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).year(), <span class="number">2020</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).year()%2C%202019)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-12-31%2023%3A00%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(%2B1))%0A%20%20%20%20%20%20%20%20.year()%2C%0A%20%20%20%202020%2C%0A)%3B%0Aassert_eq!(datetime!(2020-01-01%200%3A00%20UTC).year()%2C%202020)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.month" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#255-257">source</a><h4 class="code-header">pub const fn <a href="#method.month" class="fnname">month</a>(self) -> <a class="enum" href="enum.Month.html" title="enum time::Month">Month</a></h4></section></summary><div class="docblock"><p>Get the month of the date in the stored offset.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).month(), Month::January); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">12</span>-<span class="number">31 23</span>:<span class="number">00 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(+<span class="number">1</span>)) |
| .month(), |
| Month::January, |
| );</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%3AMonth%3B%0Ause%20time_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).month()%2C%20Month%3A%3AJanuary)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-12-31%2023%3A00%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(%2B1))%0A%20%20%20%20%20%20%20%20.month()%2C%0A%20%20%20%20Month%3A%3AJanuary%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.day" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#273-275">source</a><h4 class="code-header">pub const fn <a href="#method.day" class="fnname">day</a>(self) -> u8</h4></section></summary><div class="docblock"><p>Get the day of the date in the stored offset.</p> |
| <p>The returned value will always be in the range <code>1..=31</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).day(), <span class="number">1</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">12</span>-<span class="number">31 23</span>:<span class="number">00 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(+<span class="number">1</span>)) |
| .day(), |
| <span class="number">1</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).day()%2C%201)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-12-31%2023%3A00%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(%2B1))%0A%20%20%20%20%20%20%20%20.day()%2C%0A%20%20%20%201%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ordinal" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#291-293">source</a><h4 class="code-header">pub const fn <a href="#method.ordinal" class="fnname">ordinal</a>(self) -> u16</h4></section></summary><div class="docblock"><p>Get the day of the year of the date in the stored offset.</p> |
| <p>The returned value will always be in the range <code>1..=366</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).ordinal(), <span class="number">1</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">12</span>-<span class="number">31 23</span>:<span class="number">00 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(+<span class="number">1</span>)) |
| .ordinal(), |
| <span class="number">1</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).ordinal()%2C%201)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-12-31%2023%3A00%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(%2B1))%0A%20%20%20%20%20%20%20%20.ordinal()%2C%0A%20%20%20%201%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.iso_week" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#306-308">source</a><h4 class="code-header">pub const fn <a href="#method.iso_week" class="fnname">iso_week</a>(self) -> u8</h4></section></summary><div class="docblock"><p>Get the ISO week number of the date in the stored offset.</p> |
| <p>The returned value will always be in the range <code>1..=53</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).iso_week(), <span class="number">1</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).iso_week(), <span class="number">1</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">12</span>-<span class="number">31 0</span>:<span class="number">00 </span>UTC).iso_week(), <span class="number">53</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2021</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).iso_week(), <span class="number">53</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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).iso_week()%2C%201)%3B%0Aassert_eq!(datetime!(2020-01-01%200%3A00%20UTC).iso_week()%2C%201)%3B%0Aassert_eq!(datetime!(2020-12-31%200%3A00%20UTC).iso_week()%2C%2053)%3B%0Aassert_eq!(datetime!(2021-01-01%200%3A00%20UTC).iso_week()%2C%2053)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.sunday_based_week" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#321-323">source</a><h4 class="code-header">pub const fn <a href="#method.sunday_based_week" class="fnname">sunday_based_week</a>(self) -> u8</h4></section></summary><div class="docblock"><p>Get the week number where week 1 begins on the first Sunday.</p> |
| <p>The returned value will always be in the range <code>0..=53</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).sunday_based_week(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).sunday_based_week(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">12</span>-<span class="number">31 0</span>:<span class="number">00 </span>UTC).sunday_based_week(), <span class="number">52</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2021</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).sunday_based_week(), <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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).sunday_based_week()%2C%200)%3B%0Aassert_eq!(datetime!(2020-01-01%200%3A00%20UTC).sunday_based_week()%2C%200)%3B%0Aassert_eq!(datetime!(2020-12-31%200%3A00%20UTC).sunday_based_week()%2C%2052)%3B%0Aassert_eq!(datetime!(2021-01-01%200%3A00%20UTC).sunday_based_week()%2C%200)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.monday_based_week" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#336-338">source</a><h4 class="code-header">pub const fn <a href="#method.monday_based_week" class="fnname">monday_based_week</a>(self) -> u8</h4></section></summary><div class="docblock"><p>Get the week number where week 1 begins on the first Monday.</p> |
| <p>The returned value will always be in the range <code>0..=53</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).monday_based_week(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).monday_based_week(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">12</span>-<span class="number">31 0</span>:<span class="number">00 </span>UTC).monday_based_week(), <span class="number">52</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2021</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).monday_based_week(), <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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).monday_based_week()%2C%200)%3B%0Aassert_eq!(datetime!(2020-01-01%200%3A00%20UTC).monday_based_week()%2C%200)%3B%0Aassert_eq!(datetime!(2020-12-31%200%3A00%20UTC).monday_based_week()%2C%2052)%3B%0Aassert_eq!(datetime!(2021-01-01%200%3A00%20UTC).monday_based_week()%2C%200)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_calendar_date" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#350-352">source</a><h4 class="code-header">pub const fn <a href="#method.to_calendar_date" class="fnname">to_calendar_date</a>(self) -> (i32, <a class="enum" href="enum.Month.html" title="enum time::Month">Month</a>, u8)</h4></section></summary><div class="docblock"><p>Get the year, month, and day.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).to_calendar_date(), |
| (<span class="number">2019</span>, Month::January, <span class="number">1</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%3AMonth%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%200%3A00%20UTC).to_calendar_date()%2C%0A%20%20%20%20(2019%2C%20Month%3A%3AJanuary%2C%201)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_ordinal_date" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#363-365">source</a><h4 class="code-header">pub const fn <a href="#method.to_ordinal_date" class="fnname">to_ordinal_date</a>(self) -> (i32, u16)</h4></section></summary><div class="docblock"><p>Get the year and ordinal day number.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).to_ordinal_date(), |
| (<span class="number">2019</span>, <span class="number">1</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%200%3A00%20UTC).to_ordinal_date()%2C%0A%20%20%20%20(2019%2C%201)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_iso_week_date" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#393-395">source</a><h4 class="code-header">pub const fn <a href="#method.to_iso_week_date" class="fnname">to_iso_week_date</a>(self) -> (i32, u8, <a class="enum" href="enum.Weekday.html" title="enum time::Weekday">Weekday</a>)</h4></section></summary><div class="docblock"><p>Get the ISO 8601 year, week number, and weekday.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).to_iso_week_date(), |
| (<span class="number">2019</span>, <span class="number">1</span>, Tuesday) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">10</span>-<span class="number">04 0</span>:<span class="number">00 </span>UTC).to_iso_week_date(), |
| (<span class="number">2019</span>, <span class="number">40</span>, Friday) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).to_iso_week_date(), |
| (<span class="number">2020</span>, <span class="number">1</span>, Wednesday) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">12</span>-<span class="number">31 0</span>:<span class="number">00 </span>UTC).to_iso_week_date(), |
| (<span class="number">2020</span>, <span class="number">53</span>, Thursday) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2021</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).to_iso_week_date(), |
| (<span class="number">2020</span>, <span class="number">53</span>, Friday) |
| );</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%3AWeekday%3A%3A*%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%200%3A00%20UTC).to_iso_week_date()%2C%0A%20%20%20%20(2019%2C%201%2C%20Tuesday)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-10-04%200%3A00%20UTC).to_iso_week_date()%2C%0A%20%20%20%20(2019%2C%2040%2C%20Friday)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%200%3A00%20UTC).to_iso_week_date()%2C%0A%20%20%20%20(2020%2C%201%2C%20Wednesday)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-12-31%200%3A00%20UTC).to_iso_week_date()%2C%0A%20%20%20%20(2020%2C%2053%2C%20Thursday)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2021-01-01%200%3A00%20UTC).to_iso_week_date()%2C%0A%20%20%20%20(2020%2C%2053%2C%20Friday)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.weekday" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#406-408">source</a><h4 class="code-header">pub const fn <a href="#method.weekday" class="fnname">weekday</a>(self) -> <a class="enum" href="enum.Weekday.html" title="enum time::Weekday">Weekday</a></h4></section></summary><div class="docblock"><p>Get the weekday of the date in the stored offset.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).weekday(), Tuesday); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">02</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).weekday(), Friday); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">03</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).weekday(), Friday);</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%3AWeekday%3A%3A*%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).weekday()%2C%20Tuesday)%3B%0Aassert_eq!(datetime!(2019-02-01%200%3A00%20UTC).weekday()%2C%20Friday)%3B%0Aassert_eq!(datetime!(2019-03-01%200%3A00%20UTC).weekday()%2C%20Friday)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_julian_day" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#422-424">source</a><h4 class="code-header">pub const fn <a href="#method.to_julian_day" class="fnname">to_julian_day</a>(self) -> i32</h4></section></summary><div class="docblock"><p>Get the Julian day for the date. The time is not taken into account for this calculation.</p> |
| <p>The algorithm to perform this conversion is derived from one provided by Peter Baum; it is |
| freely available <a href="https://www.researchgate.net/publication/316558298_Date_Algorithms">here</a>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(-<span class="number">4713</span>-<span class="number">11</span>-<span class="number">24 0</span>:<span class="number">00 </span>UTC).to_julian_day(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2000</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).to_julian_day(), <span class="number">2_451_545</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).to_julian_day(), <span class="number">2_458_485</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">12</span>-<span class="number">31 0</span>:<span class="number">00 </span>UTC).to_julian_day(), <span class="number">2_458_849</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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(-4713-11-24%200%3A00%20UTC).to_julian_day()%2C%200)%3B%0Aassert_eq!(datetime!(2000-01-01%200%3A00%20UTC).to_julian_day()%2C%202_451_545)%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).to_julian_day()%2C%202_458_485)%3B%0Aassert_eq!(datetime!(2019-12-31%200%3A00%20UTC).to_julian_day()%2C%202_458_849)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_hms" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#435-437">source</a><h4 class="code-header">pub const fn <a href="#method.to_hms" class="fnname">to_hms</a>(self) -> (u8, u8, u8)</h4></section></summary><div class="docblock"><p>Get the clock hour, minute, and second.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00</span>:<span class="number">00 </span>UTC).to_hms(), (<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>)); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59 </span>UTC).to_hms(), (<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(2020-01-01%200%3A00%3A00%20UTC).to_hms()%2C%20(0%2C%200%2C%200))%3B%0Aassert_eq!(datetime!(2020-01-01%2023%3A59%3A59%20UTC).to_hms()%2C%20(23%2C%2059%2C%2059))%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_hms_milli" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#452-454">source</a><h4 class="code-header">pub const fn <a href="#method.to_hms_milli" class="fnname">to_hms_milli</a>(self) -> (u8, u8, u8, u16)</h4></section></summary><div class="docblock"><p>Get the clock hour, minute, second, and millisecond.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00</span>:<span class="number">00 </span>UTC).to_hms_milli(), |
| (<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59.999 </span>UTC).to_hms_milli(), |
| (<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">999</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%200%3A00%3A00%20UTC).to_hms_milli()%2C%0A%20%20%20%20(0%2C%200%2C%200%2C%200)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%2023%3A59%3A59.999%20UTC).to_hms_milli()%2C%0A%20%20%20%20(23%2C%2059%2C%2059%2C%20999)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_hms_micro" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#469-471">source</a><h4 class="code-header">pub const fn <a href="#method.to_hms_micro" class="fnname">to_hms_micro</a>(self) -> (u8, u8, u8, u32)</h4></section></summary><div class="docblock"><p>Get the clock hour, minute, second, and microsecond.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00</span>:<span class="number">00 </span>UTC).to_hms_micro(), |
| (<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59.999_999 </span>UTC).to_hms_micro(), |
| (<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">999_999</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%200%3A00%3A00%20UTC).to_hms_micro()%2C%0A%20%20%20%20(0%2C%200%2C%200%2C%200)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%2023%3A59%3A59.999_999%20UTC).to_hms_micro()%2C%0A%20%20%20%20(23%2C%2059%2C%2059%2C%20999_999)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_hms_nano" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#486-488">source</a><h4 class="code-header">pub const fn <a href="#method.to_hms_nano" class="fnname">to_hms_nano</a>(self) -> (u8, u8, u8, u32)</h4></section></summary><div class="docblock"><p>Get the clock hour, minute, second, and nanosecond.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00</span>:<span class="number">00 </span>UTC).to_hms_nano(), |
| (<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59.999_999_999 </span>UTC).to_hms_nano(), |
| (<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">999_999_999</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%200%3A00%3A00%20UTC).to_hms_nano()%2C%0A%20%20%20%20(0%2C%200%2C%200%2C%200)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%2023%3A59%3A59.999_999_999%20UTC).to_hms_nano()%2C%0A%20%20%20%20(23%2C%2059%2C%2059%2C%20999_999_999)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.hour" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#504-506">source</a><h4 class="code-header">pub const fn <a href="#method.hour" class="fnname">hour</a>(self) -> u8</h4></section></summary><div class="docblock"><p>Get the clock hour in the stored offset.</p> |
| <p>The returned value will always be in the range <code>0..24</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).hour(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(-<span class="number">2</span>)) |
| .hour(), |
| <span class="number">21</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).hour()%2C%200)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%2023%3A59%3A59%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(-2))%0A%20%20%20%20%20%20%20%20.hour()%2C%0A%20%20%20%2021%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.minute" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#522-524">source</a><h4 class="code-header">pub const fn <a href="#method.minute" class="fnname">minute</a>(self) -> u8</h4></section></summary><div class="docblock"><p>Get the minute within the hour in the stored offset.</p> |
| <p>The returned value will always be in the range <code>0..60</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).minute(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(+<span class="number">0</span>:<span class="number">30</span>)) |
| .minute(), |
| <span class="number">29</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).minute()%2C%200)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%2023%3A59%3A59%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(%2B0%3A30))%0A%20%20%20%20%20%20%20%20.minute()%2C%0A%20%20%20%2029%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.second" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#540-542">source</a><h4 class="code-header">pub const fn <a href="#method.second" class="fnname">second</a>(self) -> u8</h4></section></summary><div class="docblock"><p>Get the second within the minute in the stored offset.</p> |
| <p>The returned value will always be in the range <code>0..60</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).second(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59 </span>UTC) |
| .to_offset(<span class="macro">offset!</span>(+<span class="number">0</span>:<span class="number">00</span>:<span class="number">30</span>)) |
| .second(), |
| <span class="number">29</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).second()%2C%200)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%2023%3A59%3A59%20UTC)%0A%20%20%20%20%20%20%20%20.to_offset(offset!(%2B0%3A00%3A30))%0A%20%20%20%20%20%20%20%20.second()%2C%0A%20%20%20%2029%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.millisecond" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#556-558">source</a><h4 class="code-header">pub const fn <a href="#method.millisecond" class="fnname">millisecond</a>(self) -> u16</h4></section></summary><div class="docblock"><p>Get the milliseconds within the second in the stored offset.</p> |
| <p>The returned value will always be in the range <code>0..1_000</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).millisecond(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59.999 </span>UTC).millisecond(), <span class="number">999</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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).millisecond()%2C%200)%3B%0Aassert_eq!(datetime!(2019-01-01%2023%3A59%3A59.999%20UTC).millisecond()%2C%20999)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.microsecond" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#572-574">source</a><h4 class="code-header">pub const fn <a href="#method.microsecond" class="fnname">microsecond</a>(self) -> u32</h4></section></summary><div class="docblock"><p>Get the microseconds within the second in the stored offset.</p> |
| <p>The returned value will always be in the range <code>0..1_000_000</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).microsecond(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59.999_999 </span>UTC).microsecond(), |
| <span class="number">999_999</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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).microsecond()%2C%200)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%2023%3A59%3A59.999_999%20UTC).microsecond()%2C%0A%20%20%20%20999_999%2C%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.nanosecond" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#588-590">source</a><h4 class="code-header">pub const fn <a href="#method.nanosecond" class="fnname">nanosecond</a>(self) -> u32</h4></section></summary><div class="docblock"><p>Get the nanoseconds within the second in the stored offset.</p> |
| <p>The returned value will always be in the range <code>0..1_000_000_000</code>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).nanosecond(), <span class="number">0</span>); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019</span>-<span class="number">01</span>-<span class="number">01 23</span>:<span class="number">59</span>:<span class="number">59.999_999_999 </span>UTC).nanosecond(), |
| <span class="number">999_999_999</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_macros%3A%3Adatetime%3B%0Aassert_eq!(datetime!(2019-01-01%200%3A00%20UTC).nanosecond()%2C%200)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2019-01-01%2023%3A59%3A59.999_999_999%20UTC).nanosecond()%2C%0A%20%20%20%20999_999_999%2C%0A)%3B%0A%7D&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/offset_date_time.rs.html#611-613">source</a><h4 class="code-header">pub const 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>) -> Option<Self></h4></section></summary><div class="docblock"><p>Computes <code>self + duration</code>, returning <code>None</code> if an overflow occurred.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>datetime = Date::MIN.midnight().assume_offset(<span class="macro">offset!</span>(+<span class="number">10</span>)); |
| <span class="macro">assert_eq!</span>(datetime.checked_add((-<span class="number">2</span>).days()), <span class="prelude-val">None</span>); |
| |
| <span class="kw">let </span>datetime = Date::MAX.midnight().assume_offset(<span class="macro">offset!</span>(+<span class="number">10</span>)); |
| <span class="macro">assert_eq!</span>(datetime.checked_add(<span class="number">2</span>.days()), <span class="prelude-val">None</span>); |
| |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">25 15</span>:<span class="number">30 </span>+<span class="number">10</span>).checked_add(<span class="number">27</span>.hours()), |
| <span class="prelude-val">Some</span>(<span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">26 18</span>:<span class="number">30 </span>+<span class="number">10</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%3A%7BDate%2C%20ext%3A%3ANumericalDuration%7D%3B%0Ause%20time_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Alet%20datetime%20%3D%20Date%3A%3AMIN.midnight().assume_offset(offset!(%2B10))%3B%0Aassert_eq!(datetime.checked_add((-2).days())%2C%20None)%3B%0A%0Alet%20datetime%20%3D%20Date%3A%3AMAX.midnight().assume_offset(offset!(%2B10))%3B%0Aassert_eq!(datetime.checked_add(2.days())%2C%20None)%3B%0A%0Aassert_eq!(%0A%20%20%20%20datetime!(2019%20-%2011%20-%2025%2015%3A30%20%2B10).checked_add(27.hours())%2C%0A%20%20%20%20Some(datetime!(2019%20-%2011%20-%2026%2018%3A30%20%2B10))%0A)%3B%0A%7D&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/offset_date_time.rs.html#631-633">source</a><h4 class="code-header">pub const 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>) -> Option<Self></h4></section></summary><div class="docblock"><p>Computes <code>self - duration</code>, returning <code>None</code> if an overflow occurred.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>datetime = Date::MIN.midnight().assume_offset(<span class="macro">offset!</span>(+<span class="number">10</span>)); |
| <span class="macro">assert_eq!</span>(datetime.checked_sub(<span class="number">2</span>.days()), <span class="prelude-val">None</span>); |
| |
| <span class="kw">let </span>datetime = Date::MAX.midnight().assume_offset(<span class="macro">offset!</span>(+<span class="number">10</span>)); |
| <span class="macro">assert_eq!</span>(datetime.checked_sub((-<span class="number">2</span>).days()), <span class="prelude-val">None</span>); |
| |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">25 15</span>:<span class="number">30 </span>+<span class="number">10</span>).checked_sub(<span class="number">27</span>.hours()), |
| <span class="prelude-val">Some</span>(<span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">24 12</span>:<span class="number">30 </span>+<span class="number">10</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%3A%7BDate%2C%20ext%3A%3ANumericalDuration%7D%3B%0Ause%20time_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Alet%20datetime%20%3D%20Date%3A%3AMIN.midnight().assume_offset(offset!(%2B10))%3B%0Aassert_eq!(datetime.checked_sub(2.days())%2C%20None)%3B%0A%0Alet%20datetime%20%3D%20Date%3A%3AMAX.midnight().assume_offset(offset!(%2B10))%3B%0Aassert_eq!(datetime.checked_sub((-2).days())%2C%20None)%3B%0A%0Aassert_eq!(%0A%20%20%20%20datetime!(2019%20-%2011%20-%2025%2015%3A30%20%2B10).checked_sub(27.hours())%2C%0A%20%20%20%20Some(datetime!(2019%20-%2011%20-%2024%2012%3A30%20%2B10))%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.saturating_add" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#682-684">source</a><h4 class="code-header">pub const fn <a href="#method.saturating_add" class="fnname">saturating_add</a>(self, duration: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -> Self</h4></section></summary><div class="docblock"><p>Computes <code>self + duration</code>, saturating value on overflow.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(-<span class="number">9999</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>+<span class="number">10</span>).saturating_add((-<span class="number">2</span>).days()), |
| <span class="macro">datetime!</span>(-<span class="number">9999</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>+<span class="number">10</span>) |
| ); |
| |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(+<span class="number">9999</span>-<span class="number">12</span>-<span class="number">31 23</span>:<span class="number">59</span>:<span class="number">59.999_999_999 </span>+<span class="number">10</span>).saturating_add(<span class="number">2</span>.days()), |
| <span class="macro">datetime!</span>(+<span class="number">9999</span>-<span class="number">12</span>-<span class="number">31 23</span>:<span class="number">59</span>:<span class="number">59.999_999_999 </span>+<span class="number">10</span>) |
| ); |
| |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">25 15</span>:<span class="number">30 </span>+<span class="number">10</span>).saturating_add(<span class="number">27</span>.hours()), |
| <span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">26 18</span>:<span class="number">30 </span>+<span class="number">10</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%3Aext%3A%3ANumericalDuration%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(-9999-01-01%200%3A00%20%2B10).saturating_add((-2).days())%2C%0A%20%20%20%20datetime!(-9999-01-01%200%3A00%20%2B10)%0A)%3B%0A%0Aassert_eq!(%0A%20%20%20%20datetime!(%2B9999-12-31%2023%3A59%3A59.999_999_999%20%2B10).saturating_add(2.days())%2C%0A%20%20%20%20datetime!(%2B9999-12-31%2023%3A59%3A59.999_999_999%20%2B10)%0A)%3B%0A%0Aassert_eq!(%0A%20%20%20%20datetime!(2019%20-%2011%20-%2025%2015%3A30%20%2B10).saturating_add(27.hours())%2C%0A%20%20%20%20datetime!(2019%20-%2011%20-%2026%2018%3A30%20%2B10)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.saturating_sub" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#731-733">source</a><h4 class="code-header">pub const fn <a href="#method.saturating_sub" class="fnname">saturating_sub</a>(self, duration: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -> Self</h4></section></summary><div class="docblock"><p>Computes <code>self - duration</code>, saturating value on overflow.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(-<span class="number">9999</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>+<span class="number">10</span>).saturating_sub(<span class="number">2</span>.days()), |
| <span class="macro">datetime!</span>(-<span class="number">9999</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>+<span class="number">10</span>) |
| ); |
| |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(+<span class="number">9999</span>-<span class="number">12</span>-<span class="number">31 23</span>:<span class="number">59</span>:<span class="number">59.999_999_999 </span>+<span class="number">10</span>).saturating_sub((-<span class="number">2</span>).days()), |
| <span class="macro">datetime!</span>(+<span class="number">9999</span>-<span class="number">12</span>-<span class="number">31 23</span>:<span class="number">59</span>:<span class="number">59.999_999_999 </span>+<span class="number">10</span>) |
| ); |
| |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">25 15</span>:<span class="number">30 </span>+<span class="number">10</span>).saturating_sub(<span class="number">27</span>.hours()), |
| <span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">24 12</span>:<span class="number">30 </span>+<span class="number">10</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%3Aext%3A%3ANumericalDuration%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(-9999-01-01%200%3A00%20%2B10).saturating_sub(2.days())%2C%0A%20%20%20%20datetime!(-9999-01-01%200%3A00%20%2B10)%0A)%3B%0A%0Aassert_eq!(%0A%20%20%20%20datetime!(%2B9999-12-31%2023%3A59%3A59.999_999_999%20%2B10).saturating_sub((-2).days())%2C%0A%20%20%20%20datetime!(%2B9999-12-31%2023%3A59%3A59.999_999_999%20%2B10)%0A)%3B%0A%0Aassert_eq!(%0A%20%20%20%20datetime!(2019%20-%2011%20-%2025%2015%3A30%20%2B10).saturating_sub(27.hours())%2C%0A%20%20%20%20datetime!(2019%20-%2011%20-%2024%2012%3A30%20%2B10)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-OffsetDateTime-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#739-949">source</a><a href="#impl-OffsetDateTime-1" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="docblock"><p>Methods that replace part of the <code>OffsetDateTime</code>.</p> |
| </div><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_time" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#759-761">source</a><h4 class="code-header">pub const fn <a href="#method.replace_time" class="fnname">replace_time</a>(self, time: <a class="struct" href="struct.Time.html" title="struct time::Time">Time</a>) -> Self</h4></section></summary><div class="docblock"><p>Replace the time, which is assumed to be in the stored offset. The date and offset |
| components are unchanged.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 5</span>:<span class="number">00 </span>UTC).replace_time(<span class="macro">time!</span>(<span class="number">12</span>:<span class="number">00</span>)), |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 12</span>:<span class="number">00 </span>UTC) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 12</span>:<span class="number">00 </span>-<span class="number">5</span>).replace_time(<span class="macro">time!</span>(<span class="number">7</span>:<span class="number">00</span>)), |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 7</span>:<span class="number">00 </span>-<span class="number">5</span>) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>+<span class="number">1</span>).replace_time(<span class="macro">time!</span>(<span class="number">12</span>:<span class="number">00</span>)), |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 12</span>:<span class="number">00 </span>+<span class="number">1</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_macros%3A%3A%7Bdatetime%2C%20time%7D%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%205%3A00%20UTC).replace_time(time!(12%3A00))%2C%0A%20%20%20%20datetime!(2020-01-01%2012%3A00%20UTC)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%2012%3A00%20-5).replace_time(time!(7%3A00))%2C%0A%20%20%20%20datetime!(2020-01-01%207%3A00%20-5)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%200%3A00%20%2B1).replace_time(time!(12%3A00))%2C%0A%20%20%20%20datetime!(2020-01-01%2012%3A00%20%2B1)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_date" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#778-780">source</a><h4 class="code-header">pub const fn <a href="#method.replace_date" class="fnname">replace_date</a>(self, date: <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a>) -> Self</h4></section></summary><div class="docblock"><p>Replace the date, which is assumed to be in the stored offset. The time and offset |
| components are unchanged.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 12</span>:<span class="number">00 </span>UTC).replace_date(<span class="macro">date!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">30</span>)), |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">30 12</span>:<span class="number">00 </span>UTC) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>+<span class="number">1</span>).replace_date(<span class="macro">date!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">30</span>)), |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">30 0</span>:<span class="number">00 </span>+<span class="number">1</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_macros%3A%3A%7Bdatetime%2C%20date%7D%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%2012%3A00%20UTC).replace_date(date!(2020-01-30))%2C%0A%20%20%20%20datetime!(2020-01-30%2012%3A00%20UTC)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%200%3A00%20%2B1).replace_date(date!(2020-01-30))%2C%0A%20%20%20%20datetime!(2020-01-30%200%3A00%20%2B1)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_date_time" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#797-799">source</a><h4 class="code-header">pub const fn <a href="#method.replace_date_time" class="fnname">replace_date_time</a>(self, date_time: <a class="struct" href="struct.PrimitiveDateTime.html" title="struct time::PrimitiveDateTime">PrimitiveDateTime</a>) -> Self</h4></section></summary><div class="docblock"><p>Replace the date and time, which are assumed to be in the stored offset. The offset |
| component remains unchanged.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 12</span>:<span class="number">00 </span>UTC).replace_date_time(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">30 16</span>:<span class="number">00</span>)), |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">30 16</span>:<span class="number">00 </span>UTC) |
| ); |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 12</span>:<span class="number">00 </span>+<span class="number">1</span>).replace_date_time(<span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">30 0</span>:<span class="number">00</span>)), |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">30 0</span>:<span class="number">00 </span>+<span class="number">1</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%2012%3A00%20UTC).replace_date_time(datetime!(2020-01-30%2016%3A00))%2C%0A%20%20%20%20datetime!(2020-01-30%2016%3A00%20UTC)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%2012%3A00%20%2B1).replace_date_time(datetime!(2020-01-30%200%3A00))%2C%0A%20%20%20%20datetime!(2020-01-30%200%3A00%20%2B1)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_offset" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#811-813">source</a><h4 class="code-header">pub const fn <a href="#method.replace_offset" class="fnname">replace_offset</a>(self, offset: <a class="struct" href="struct.UtcOffset.html" title="struct time::UtcOffset">UtcOffset</a>) -> Self</h4></section></summary><div class="docblock"><p>Replace the offset. The date and time components remain unchanged.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>UTC).replace_offset(<span class="macro">offset!</span>(-<span class="number">5</span>)), |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">01 0</span>:<span class="number">00 </span>-<span class="number">5</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_macros%3A%3A%7Bdatetime%2C%20offset%7D%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-01%200%3A00%20UTC).replace_offset(offset!(-5))%2C%0A%20%20%20%20datetime!(2020-01-01%200%3A00%20-5)%0A)%3B%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_year" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#826-828">source</a><h4 class="code-header">pub const fn <a href="#method.replace_year" class="fnname">replace_year</a>(self, year: i32) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the year. The month and day will be unchanged.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>).replace_year(<span class="number">2019</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2019 </span>- <span class="number">02 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>).replace_year(-<span class="number">1_000_000_000</span>).is_err()); <span class="comment">// -1_000_000_000 isn't a valid year |
| </span><span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>).replace_year(<span class="number">1_000_000_000</span>).is_err()); <span class="comment">// 1_000_000_000 isn't a valid year</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2012%3A00%20%2B01).replace_year(2019)%2C%0A%20%20%20%20Ok(datetime!(2019%20-%2002%20-%2018%2012%3A00%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2002%20-%2018%2012%3A00%20%2B01).replace_year(-1_000_000_000).is_err())%3B%20%2F%2F%20-1_000_000_000%20isn't%20a%20valid%20year%0Aassert!(datetime!(2022%20-%2002%20-%2018%2012%3A00%20%2B01).replace_year(1_000_000_000).is_err())%3B%20%2F%2F%201_000_000_000%20isn't%20a%20valid%20year%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_month" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#841-843">source</a><h4 class="code-header">pub const fn <a href="#method.replace_month" class="fnname">replace_month</a>(self, month: <a class="enum" href="enum.Month.html" title="enum time::Month">Month</a>) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the month of the year.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>).replace_month(Month::January), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">01 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">01 </span>- <span class="number">30 12</span>:<span class="number">00 </span>+<span class="number">01</span>).replace_month(Month::February).is_err()); <span class="comment">// 30 isn't a valid day in February</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_macros%3A%3Adatetime%3B%0Ause%20time%3A%3AMonth%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2012%3A00%20%2B01).replace_month(Month%3A%3AJanuary)%2C%0A%20%20%20%20Ok(datetime!(2022%20-%2001%20-%2018%2012%3A00%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2001%20-%2030%2012%3A00%20%2B01).replace_month(Month%3A%3AFebruary).is_err())%3B%20%2F%2F%2030%20isn't%20a%20valid%20day%20in%20February%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_day" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#856-858">source</a><h4 class="code-header">pub const fn <a href="#method.replace_day" class="fnname">replace_day</a>(self, day: u8) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the day of the month.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>).replace_day(<span class="number">1</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">01 12</span>:<span class="number">00 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>).replace_day(<span class="number">0</span>).is_err()); <span class="comment">// 00 isn't a valid day |
| </span><span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 12</span>:<span class="number">00 </span>+<span class="number">01</span>).replace_day(<span class="number">30</span>).is_err()); <span class="comment">// 30 isn't a valid day in February</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2012%3A00%20%2B01).replace_day(1)%2C%0A%20%20%20%20Ok(datetime!(2022%20-%2002%20-%2001%2012%3A00%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2002%20-%2018%2012%3A00%20%2B01).replace_day(0).is_err())%3B%20%2F%2F%2000%20isn't%20a%20valid%20day%0Aassert!(datetime!(2022%20-%2002%20-%2018%2012%3A00%20%2B01).replace_day(30).is_err())%3B%20%2F%2F%2030%20isn't%20a%20valid%20day%20in%20February%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_hour" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#870-872">source</a><h4 class="code-header">pub const fn <a href="#method.replace_hour" class="fnname">replace_hour</a>(self, hour: u8) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the clock hour.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_hour(<span class="number">7</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 07</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_hour(<span class="number">24</span>).is_err()); <span class="comment">// 24 isn't a valid hour</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_hour(7)%2C%0A%20%20%20%20Ok(datetime!(2022%20-%2002%20-%2018%2007%3A02%3A03.004_005_006%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_hour(24).is_err())%3B%20%2F%2F%2024%20isn't%20a%20valid%20hour%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_minute" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#884-886">source</a><h4 class="code-header">pub const fn <a href="#method.replace_minute" class="fnname">replace_minute</a>(self, minute: u8) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the minutes within the hour.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_minute(<span class="number">7</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">07</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_minute(<span class="number">60</span>).is_err()); <span class="comment">// 60 isn't a valid minute</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_minute(7)%2C%0A%20%20%20%20Ok(datetime!(2022%20-%2002%20-%2018%2001%3A07%3A03.004_005_006%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_minute(60).is_err())%3B%20%2F%2F%2060%20isn't%20a%20valid%20minute%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_second" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#898-900">source</a><h4 class="code-header">pub const fn <a href="#method.replace_second" class="fnname">replace_second</a>(self, second: u8) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the seconds within the minute.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_second(<span class="number">7</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">07.004_005_006 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_second(<span class="number">60</span>).is_err()); <span class="comment">// 60 isn't a valid second</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_second(7)%2C%0A%20%20%20%20Ok(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A07.004_005_006%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_second(60).is_err())%3B%20%2F%2F%2060%20isn't%20a%20valid%20second%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_millisecond" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#912-917">source</a><h4 class="code-header">pub const fn <a href="#method.replace_millisecond" class="fnname">replace_millisecond</a>(<br> self,<br> millisecond: u16<br>) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the milliseconds within the second.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_millisecond(<span class="number">7</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.007 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_millisecond(<span class="number">1_000</span>).is_err()); <span class="comment">// 1_000 isn't a valid millisecond</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_millisecond(7)%2C%0A%20%20%20%20Ok(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.007%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_millisecond(1_000).is_err())%3B%20%2F%2F%201_000%20isn't%20a%20valid%20millisecond%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_microsecond" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#929-934">source</a><h4 class="code-header">pub const fn <a href="#method.replace_microsecond" class="fnname">replace_microsecond</a>(<br> self,<br> microsecond: u32<br>) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the microseconds within the second.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_microsecond(<span class="number">7_008</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.007_008 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_microsecond(<span class="number">1_000_000</span>).is_err()); <span class="comment">// 1_000_000 isn't a valid microsecond</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_microsecond(7_008)%2C%0A%20%20%20%20Ok(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.007_008%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_microsecond(1_000_000).is_err())%3B%20%2F%2F%201_000_000%20isn't%20a%20valid%20microsecond%0A%7D&edition=2021">Run</a></div> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.replace_nanosecond" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#946-948">source</a><h4 class="code-header">pub const fn <a href="#method.replace_nanosecond" class="fnname">replace_nanosecond</a>(<br> self,<br> nanosecond: u32<br>) -> Result<Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>></h4></section></summary><div class="docblock"><p>Replace the nanoseconds within the second.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_nanosecond(<span class="number">7_008_009</span>), |
| <span class="prelude-val">Ok</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.007_008_009 </span>+<span class="number">01</span>)) |
| ); |
| <span class="macro">assert!</span>(<span class="macro">datetime!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18 01</span>:<span class="number">02</span>:<span class="number">03.004_005_006 </span>+<span class="number">01</span>).replace_nanosecond(<span class="number">1_000_000_000</span>).is_err()); <span class="comment">// 1_000_000_000 isn't a valid nanosecond</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_macros%3A%3Adatetime%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_nanosecond(7_008_009)%2C%0A%20%20%20%20Ok(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.007_008_009%20%2B01))%0A)%3B%0Aassert!(datetime!(2022%20-%2002%20-%2018%2001%3A02%3A03.004_005_006%20%2B01).replace_nanosecond(1_000_000_000).is_err())%3B%20%2F%2F%201_000_000_000%20isn't%20a%20valid%20nanosecond%0A%7D&edition=2021">Run</a></div> |
| </div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-OffsetDateTime-2" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#954-984">source</a><a href="#impl-OffsetDateTime-2" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.format_into" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#957-963">source</a><h4 class="code-header">pub fn <a href="#method.format_into" class="fnname">format_into</a>(<br> self,<br> output: &mut impl Write,<br> format: &impl <a class="trait" href="formatting/trait.Formattable.html" title="trait time::formatting::Formattable">Formattable</a> + ?Sized<br>) -> Result<usize, <a class="enum" href="error/enum.Format.html" title="enum time::error::Format">Format</a>></h4></section></summary><div class="docblock"><p>Format the <code>OffsetDateTime</code> using the provided <a href="format_description/index.html">format |
| description</a>.</p> |
| </div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.format" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#981-983">source</a><h4 class="code-header">pub fn <a href="#method.format" class="fnname">format</a>(self, format: &impl <a class="trait" href="formatting/trait.Formattable.html" title="trait time::formatting::Formattable">Formattable</a> + ?Sized) -> Result<String, <a class="enum" href="error/enum.Format.html" title="enum time::error::Format">Format</a>></h4></section></summary><div class="docblock"><p>Format the <code>OffsetDateTime</code> using the provided <a href="format_description/index.html">format |
| description</a>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>format = format_description::parse( |
| <span class="string">"[year]-[month]-[day] [hour]:[minute]:[second] [offset_hour \ |
| sign:mandatory]:[offset_minute]:[offset_second]"</span>, |
| )<span class="question-mark">?</span>; |
| <span class="macro">assert_eq!</span>( |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">02 03</span>:<span class="number">04</span>:<span class="number">05 </span>+<span class="number">06</span>:<span class="number">07</span>:<span class="number">08</span>).format(<span class="kw-2">&</span>format)<span class="question-mark">?</span>, |
| <span class="string">"2020-01-02 03:04:05 +06:07:08" |
| </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%20fn%20_inner()%20-%3E%20Result%3C()%2C%20impl%20core%3A%3Afmt%3A%3ADebug%3E%20%7B%0Ause%20time%3A%3Aformat_description%3B%0Ause%20time_macros%3A%3Adatetime%3B%0Alet%20format%20%3D%20format_description%3A%3Aparse(%0A%20%20%20%20%22%5Byear%5D-%5Bmonth%5D-%5Bday%5D%20%5Bhour%5D%3A%5Bminute%5D%3A%5Bsecond%5D%20%5Boffset_hour%20%5C%0A%20%20%20%20%20%20%20%20%20sign%3Amandatory%5D%3A%5Boffset_minute%5D%3A%5Boffset_second%5D%22%2C%0A)%3F%3B%0Aassert_eq!(%0A%20%20%20%20datetime!(2020-01-02%2003%3A04%3A05%20%2B06%3A07%3A08).format(%26format)%3F%2C%0A%20%20%20%20%222020-01-02%2003%3A04%3A05%20%2B06%3A07%3A08%22%0A)%3B%0AOk%3A%3A%3C_%2C%20time%3A%3AError%3E(())%0A%7D%20_inner().unwrap()%20%7D&edition=2021">Run</a></div> |
| </div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-OffsetDateTime-3" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#987-1010">source</a><a href="#impl-OffsetDateTime-3" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.parse" class="method has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1004-1009">source</a><h4 class="code-header">pub fn <a href="#method.parse" class="fnname">parse</a>(<br> input: &str,<br> description: &impl <a class="trait" href="parsing/trait.Parsable.html" title="trait time::parsing::Parsable">Parsable</a> + ?Sized<br>) -> Result<Self, <a class="enum" href="error/enum.Parse.html" title="enum time::error::Parse">Parse</a>></h4></section></summary><div class="docblock"><p>Parse an <code>OffsetDateTime</code> from the input using the provided <a href="format_description/index.html">format |
| description</a>.</p> |
| |
| <div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>format = <span class="macro">format_description!</span>( |
| <span class="string">"[year]-[month]-[day] [hour]:[minute]:[second] [offset_hour \ |
| sign:mandatory]:[offset_minute]:[offset_second]" |
| </span>); |
| <span class="macro">assert_eq!</span>( |
| OffsetDateTime::parse(<span class="string">"2020-01-02 03:04:05 +06:07:08"</span>, <span class="kw-2">&</span>format)<span class="question-mark">?</span>, |
| <span class="macro">datetime!</span>(<span class="number">2020</span>-<span class="number">01</span>-<span class="number">02 03</span>:<span class="number">04</span>:<span class="number">05 </span>+<span class="number">06</span>:<span class="number">07</span>:<span class="number">08</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%20fn%20_inner()%20-%3E%20Result%3C()%2C%20impl%20core%3A%3Afmt%3A%3ADebug%3E%20%7B%0Ause%20time%3A%3AOffsetDateTime%3B%0Ause%20time_macros%3A%3A%7Bdatetime%2C%20format_description%7D%3B%0Alet%20format%20%3D%20format_description!(%0A%20%20%20%20%22%5Byear%5D-%5Bmonth%5D-%5Bday%5D%20%5Bhour%5D%3A%5Bminute%5D%3A%5Bsecond%5D%20%5Boffset_hour%20%5C%0A%20%20%20%20%20%20%20%20%20sign%3Amandatory%5D%3A%5Boffset_minute%5D%3A%5Boffset_second%5D%22%0A)%3B%0Aassert_eq!(%0A%20%20%20%20OffsetDateTime%3A%3Aparse(%222020-01-02%2003%3A04%3A05%20%2B06%3A07%3A08%22%2C%20%26format)%3F%2C%0A%20%20%20%20datetime!(2020-01-02%2003%3A04%3A05%20%2B06%3A07%3A08)%0A)%3B%0AOk%3A%3A%3C_%2C%20time%3A%3AError%3E(())%0A%7D%20_inner().unwrap()%20%7D&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-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1026-1032">source</a><a href="#impl-Add%3CDuration%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Add<<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1029-1031">source</a><a href="#method.add" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add</a>(self, rhs: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -> 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-Add%3CDuration%3E-for-OffsetDateTime-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1034-1040">source</a><a href="#impl-Add%3CDuration%3E-for-OffsetDateTime-1" class="anchor"></a><h3 class="code-header">impl Add<Duration> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1037-1039">source</a><a href="#method.add-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add</a>(self, rhs: StdDuration) -> 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-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1042-1046">source</a><a href="#impl-AddAssign%3CDuration%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl AddAssign<<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1043-1045">source</a><a href="#method.add_assign" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add_assign</a>(&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-OffsetDateTime-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1048-1052">source</a><a href="#impl-AddAssign%3CDuration%3E-for-OffsetDateTime-1" class="anchor"></a><h3 class="code-header">impl AddAssign<Duration> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1049-1051">source</a><a href="#method.add_assign-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add_assign</a>(&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-Clone-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-Clone-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Clone for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#29">source</a><a href="#method.clone" class="anchor"></a><h4 class="code-header">fn <a class="fnname">clone</a>(&self) -> <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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>(&mut self, source: &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-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1018-1022">source</a><a href="#impl-Debug-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Debug for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.fmt-1" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1019-1021">source</a><a href="#method.fmt-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">fmt</a>(&self, f: &mut Formatter<'_>) -> 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-Deserialize%3C%27a%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/serde/mod.rs.html#311-319">source</a><a href="#impl-Deserialize%3C%27a%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<'a> <a class="trait" href="../serde/de/trait.Deserialize.html" title="trait serde::de::Deserialize">Deserialize</a><'a> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.deserialize" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/serde/mod.rs.html#312-318">source</a><a href="#method.deserialize" class="anchor"></a><h4 class="code-header">fn <a href="../serde/de/trait.Deserialize.html#tymethod.deserialize" class="fnname">deserialize</a><D: <a class="trait" href="../serde/de/trait.Deserializer.html" title="trait serde::de::Deserializer">Deserializer</a><'a>>(deserializer: D) -> Result<Self, D::<a class="associatedtype" href="../serde/de/trait.Deserializer.html#associatedtype.Error" title="type serde::de::Deserializer::Error">Error</a>></h4></section></summary><div class='docblock'>Deserialize this value from the given Serde deserializer. <a href="../serde/de/trait.Deserialize.html#tymethod.deserialize">Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Display-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1012-1016">source</a><a href="#impl-Display-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Display for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1013-1015">source</a><a href="#method.fmt" class="anchor"></a><h4 class="code-header">fn <a class="fnname">fmt</a>(&self, f: &mut Formatter<'_>) -> 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%3COffsetDateTime%3E-for-SystemTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1144-1148">source</a><a href="#impl-From%3COffsetDateTime%3E-for-SystemTime" class="anchor"></a><h3 class="code-header">impl From<<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>> for SystemTime</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/offset_date_time.rs.html#1145-1147">source</a><a href="#method.from-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(datetime: <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>) -> 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%3CSystemTime%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1137-1141">source</a><a href="#impl-From%3CSystemTime%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl From<SystemTime> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1138-1140">source</a><a href="#method.from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(system_time: SystemTime) -> 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-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-Hash-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Hash for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#29">source</a><a href="#method.hash" class="anchor"></a><h4 class="code-header">fn <a class="fnname">hash</a><__H: Hasher>(&self, state: &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><H>(data: &[Self], state: &mut H)<span class="where fmt-newline">where<br> 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-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-Ord-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Ord for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#29">source</a><a href="#method.cmp" class="anchor"></a><h4 class="code-header">fn <a class="fnname">cmp</a>(&self, other: &<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>) -> 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) -> 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) -> 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) -> Self<span class="where fmt-newline">where<br> Self: PartialOrd<Self>,</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%3COffsetDateTime%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-PartialEq%3COffsetDateTime%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl PartialEq<<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#29">source</a><a href="#method.eq" class="anchor"></a><h4 class="code-header">fn <a class="fnname">eq</a>(&self, other: &<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>) -> 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>(&self, other: &Rhs) -> 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%3COffsetDateTime%3E-for-SystemTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1116-1120">source</a><a href="#impl-PartialEq%3COffsetDateTime%3E-for-SystemTime" class="anchor"></a><h3 class="code-header">impl PartialEq<<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>> for SystemTime</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/offset_date_time.rs.html#1117-1119">source</a><a href="#method.eq-2" class="anchor"></a><h4 class="code-header">fn <a class="fnname">eq</a>(&self, rhs: &<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>) -> 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>(&self, other: &Rhs) -> 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%3CSystemTime%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1109-1113">source</a><a href="#impl-PartialEq%3CSystemTime%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl PartialEq<SystemTime> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1110-1112">source</a><a href="#method.eq-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">eq</a>(&self, rhs: &SystemTime) -> 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>(&self, other: &Rhs) -> 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%3COffsetDateTime%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-PartialOrd%3COffsetDateTime%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl PartialOrd<<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#29">source</a><a href="#method.partial_cmp" class="anchor"></a><h4 class="code-header">fn <a class="fnname">partial_cmp</a>(&self, other: &<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>) -> Option<Ordering></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>(&self, other: &Rhs) -> 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><</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>(&self, other: &Rhs) -> 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><=</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>(&self, other: &Rhs) -> 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>></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>(&self, other: &Rhs) -> 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>>=</code> |
| operator. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialOrd%3COffsetDateTime%3E-for-SystemTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1130-1134">source</a><a href="#impl-PartialOrd%3COffsetDateTime%3E-for-SystemTime" class="anchor"></a><h3 class="code-header">impl PartialOrd<<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>> for SystemTime</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/offset_date_time.rs.html#1131-1133">source</a><a href="#method.partial_cmp-2" class="anchor"></a><h4 class="code-header">fn <a class="fnname">partial_cmp</a>(&self, other: &<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>) -> Option<Ordering></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>(&self, other: &Rhs) -> 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><</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>(&self, other: &Rhs) -> 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><=</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>(&self, other: &Rhs) -> 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>></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>(&self, other: &Rhs) -> 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>>=</code> |
| operator. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialOrd%3CSystemTime%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1123-1127">source</a><a href="#impl-PartialOrd%3CSystemTime%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl PartialOrd<SystemTime> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1124-1126">source</a><a href="#method.partial_cmp-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">partial_cmp</a>(&self, other: &SystemTime) -> Option<Ordering></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>(&self, other: &Rhs) -> 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><</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>(&self, other: &Rhs) -> 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><=</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>(&self, other: &Rhs) -> 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>></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>(&self, other: &Rhs) -> 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>>=</code> |
| operator. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Serialize-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/serde/mod.rs.html#286-309">source</a><a href="#impl-Serialize-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl <a class="trait" href="../serde/ser/trait.Serialize.html" title="trait serde::ser::Serialize">Serialize</a> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.serialize" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/serde/mod.rs.html#287-308">source</a><a href="#method.serialize" class="anchor"></a><h4 class="code-header">fn <a href="../serde/ser/trait.Serialize.html#tymethod.serialize" class="fnname">serialize</a><S: <a class="trait" href="../serde/ser/trait.Serializer.html" title="trait serde::ser::Serializer">Serializer</a>>(&self, serializer: S) -> Result<S::<a class="associatedtype" href="../serde/ser/trait.Serializer.html#associatedtype.Ok" title="type serde::ser::Serializer::Ok">Ok</a>, S::<a class="associatedtype" href="../serde/ser/trait.Serializer.html#associatedtype.Error" title="type serde::ser::Serializer::Error">Error</a>></h4></section></summary><div class='docblock'>Serialize this value into the given Serde serializer. <a href="../serde/ser/trait.Serialize.html#tymethod.serialize">Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Sub%3CDuration%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1054-1060">source</a><a href="#impl-Sub%3CDuration%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Sub<<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></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.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1057-1059">source</a><a href="#method.sub" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, rhs: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -> 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%3CDuration%3E-for-OffsetDateTime-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1062-1068">source</a><a href="#impl-Sub%3CDuration%3E-for-OffsetDateTime-1" class="anchor"></a><h3 class="code-header">impl Sub<Duration> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="impl-items"><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.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1065-1067">source</a><a href="#method.sub-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, rhs: StdDuration) -> 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%3COffsetDateTime%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1082-1088">source</a><a href="#impl-Sub%3COffsetDateTime%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Sub<<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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.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/offset_date_time.rs.html#1085-1087">source</a><a href="#method.sub-2" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, rhs: Self) -> 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%3COffsetDateTime%3E-for-SystemTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1100-1106">source</a><a href="#impl-Sub%3COffsetDateTime%3E-for-SystemTime" class="anchor"></a><h3 class="code-header">impl Sub<<a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>> for SystemTime</h3></section></summary><div class="impl-items"><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.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-4" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1103-1105">source</a><a href="#method.sub-4" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, rhs: <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a>) -> 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%3CSystemTime%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1091-1097">source</a><a href="#impl-Sub%3CSystemTime%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Sub<SystemTime> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section></summary><div class="impl-items"><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.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-3" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1094-1096">source</a><a href="#method.sub-3" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, rhs: SystemTime) -> 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-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1070-1074">source</a><a href="#impl-SubAssign%3CDuration%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl SubAssign<<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1071-1073">source</a><a href="#method.sub_assign" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub_assign</a>(&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-OffsetDateTime-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#1076-1080">source</a><a href="#impl-SubAssign%3CDuration%3E-for-OffsetDateTime-1" class="anchor"></a><h3 class="code-header">impl SubAssign<Duration> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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/offset_date_time.rs.html#1077-1079">source</a><a href="#method.sub_assign-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub_assign</a>(&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-TryFrom%3CParsed%3E-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/parsing/parsed.rs.html#782-788">source</a><a href="#impl-TryFrom%3CParsed%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl TryFrom<<a class="struct" href="parsing/struct.Parsed.html" title="struct time::parsing::Parsed">Parsed</a>> for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></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> = <DateTime<Fixed> as TryFrom<<a class="struct" href="parsing/struct.Parsed.html" title="struct time::parsing::Parsed">Parsed</a>>>::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_from" class="method trait-impl has-srclink"><a class="srclink rightside" href="../src/time/parsing/parsed.rs.html#785-787">source</a><a href="#method.try_from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_from</a>(parsed: <a class="struct" href="parsing/struct.Parsed.html" title="struct time::parsing::Parsed">Parsed</a>) -> Result<Self, Self::Error></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><section id="impl-Copy-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-Copy-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Copy for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section><section id="impl-Eq-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-Eq-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Eq for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section><section id="impl-StructuralEq-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-StructuralEq-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl StructuralEq for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section><section id="impl-StructuralPartialEq-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/time/offset_date_time.rs.html#29">source</a><a href="#impl-StructuralPartialEq-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl StructuralPartialEq for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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-OffsetDateTime" class="impl has-srclink"><a href="#impl-RefUnwindSafe-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl RefUnwindSafe for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section><section id="impl-Send-for-OffsetDateTime" class="impl has-srclink"><a href="#impl-Send-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Send for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section><section id="impl-Sync-for-OffsetDateTime" class="impl has-srclink"><a href="#impl-Sync-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Sync for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section><section id="impl-Unpin-for-OffsetDateTime" class="impl has-srclink"><a href="#impl-Unpin-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl Unpin for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</a></h3></section><section id="impl-UnwindSafe-for-OffsetDateTime" class="impl has-srclink"><a href="#impl-UnwindSafe-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl UnwindSafe for <a class="struct" href="struct.OffsetDateTime.html" title="struct time::OffsetDateTime">OffsetDateTime</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-OffsetDateTime" class="impl has-srclink"><a href="#impl-Any-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T> Any for T<span class="where fmt-newline">where<br> 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>(&self) -> 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-OffsetDateTime" class="impl has-srclink"><a href="#impl-Borrow%3CT%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T> Borrow<T> for T<span class="where fmt-newline">where<br> T: ?Sized,</span></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"><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" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow</a>(&self) -> &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-OffsetDateTime" class="impl has-srclink"><a href="#impl-BorrowMut%3CT%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T> BorrowMut<T> for T<span class="where fmt-newline">where<br> 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>(&mut self) -> &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-OffsetDateTime" class="impl has-srclink"><a href="#impl-From%3CT%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T> From<T> 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) -> 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-OffsetDateTime" class="impl has-srclink"><a href="#impl-Into%3CU%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T, U> Into<U> for T<span class="where fmt-newline">where<br> U: From<T>,</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) -> 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]<T> for U</code> chooses to do.</p> |
| </div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-ToOwned-for-OffsetDateTime" class="impl has-srclink"><a href="#impl-ToOwned-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T> ToOwned for T<span class="where fmt-newline">where<br> 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>(&self) -> 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>(&self, target: &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-ToString-for-OffsetDateTime" class="impl has-srclink"><a href="#impl-ToString-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T> ToString for T<span class="where fmt-newline">where<br> T: Display + ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_string" class="method trait-impl has-srclink"><a href="#method.to_string" class="anchor"></a><h4 class="code-header">default fn <a class="fnname">to_string</a>(&self) -> String</h4></section></summary><div class='docblock'>Converts the given value to a <code>String</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-OffsetDateTime" class="impl has-srclink"><a href="#impl-TryFrom%3CU%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T, U> TryFrom<U> for T<span class="where fmt-newline">where<br> U: Into<T>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-2" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error-2" 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-1" 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-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_from</a>(value: U) -> Result<T, <T as TryFrom<U>>::Error></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-OffsetDateTime" class="impl has-srclink"><a href="#impl-TryInto%3CU%3E-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T, U> TryInto<U> for T<span class="where fmt-newline">where<br> U: TryFrom<T>,</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> = <U as TryFrom<T>>::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) -> Result<U, <U as TryFrom<T>>::Error></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><section id="impl-DeserializeOwned-for-OffsetDateTime" class="impl has-srclink"><a class="srclink rightside" href="../src/serde/de/mod.rs.html#604">source</a><a href="#impl-DeserializeOwned-for-OffsetDateTime" class="anchor"></a><h3 class="code-header">impl<T> <a class="trait" href="../serde/de/trait.DeserializeOwned.html" title="trait serde::de::DeserializeOwned">DeserializeOwned</a> for T<span class="where fmt-newline">where<br> T: for<'de> <a class="trait" href="../serde/de/trait.Deserialize.html" title="trait serde::de::Deserialize">Deserialize</a><'de>,</span></h3></section></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> |
