blob: 780ceaf2992c8d1e69c600c6f437d5a4c0b99f64 [file] [log] [blame]
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Date in the proleptic Gregorian calendar."><meta name="keywords" content="rust, rustlang, rust-lang, Date"><title>Date in time - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" href="../normalize.css"><link rel="stylesheet" href="../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" href="../ayu.css" disabled><link rel="stylesheet" href="../dark.css" disabled><link rel="stylesheet" href="../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../storage.js"></script><script defer src="sidebar-items.js"></script><script defer src="../main.js"></script><noscript><link rel="stylesheet" href="../noscript.css"></noscript><link rel="icon" href="https://avatars0.githubusercontent.com/u/55999857"></head><body class="rustdoc struct"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">&#9776;</button><a class="sidebar-logo" href="../time/index.html"><div class="logo-container"><img src="https://avatars0.githubusercontent.com/u/55999857" alt="logo"></div></a><h2></h2></nav><nav class="sidebar"><a class="sidebar-logo" href="../time/index.html"><div class="logo-container">
<img src="https://avatars0.githubusercontent.com/u/55999857" alt="logo"></div></a><h2 class="location"><a href="#">Date</a></h2><div class="sidebar-elems"><section><h3><a href="#implementations">Associated Constants</a></h3><ul class="block"><li><a href="#associatedconstant.MAX">MAX</a></li><li><a href="#associatedconstant.MIN">MIN</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.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_calendar_date">from_calendar_date</a></li><li><a href="#method.from_iso_week_date">from_iso_week_date</a></li><li><a href="#method.from_julian_day">from_julian_day</a></li><li><a href="#method.from_ordinal_date">from_ordinal_date</a></li><li><a href="#method.iso_week">iso_week</a></li><li><a href="#method.midnight">midnight</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.next_day">next_day</a></li><li><a href="#method.ordinal">ordinal</a></li><li><a href="#method.parse">parse</a></li><li><a href="#method.previous_day">previous_day</a></li><li><a href="#method.replace_day">replace_day</a></li><li><a href="#method.replace_month">replace_month</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.sunday_based_week">sunday_based_week</a></li><li><a href="#method.to_calendar_date">to_calendar_date</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_ordinal_date">to_ordinal_date</a></li><li><a href="#method.weekday">weekday</a></li><li><a href="#method.with_hms">with_hms</a></li><li><a href="#method.with_hms_micro">with_hms_micro</a></li><li><a href="#method.with_hms_milli">with_hms_milli</a></li><li><a href="#method.with_hms_nano">with_hms_nano</a></li><li><a href="#method.with_time">with_time</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-Date">Add&lt;Duration&gt;</a></li><li><a href="#impl-Add%3CDuration%3E-for-Date-1">Add&lt;Duration&gt;</a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-Date">AddAssign&lt;Duration&gt;</a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-Date-1">AddAssign&lt;Duration&gt;</a></li><li><a href="#impl-Clone-for-Date">Clone</a></li><li><a href="#impl-Copy-for-Date">Copy</a></li><li><a href="#impl-Debug-for-Date">Debug</a></li><li><a href="#impl-Deserialize%3C%27a%3E-for-Date">Deserialize&lt;&#39;a&gt;</a></li><li><a href="#impl-Display-for-Date">Display</a></li><li><a href="#impl-Eq-for-Date">Eq</a></li><li><a href="#impl-Hash-for-Date">Hash</a></li><li><a href="#impl-Ord-for-Date">Ord</a></li><li><a href="#impl-PartialEq%3CDate%3E-for-Date">PartialEq&lt;Date&gt;</a></li><li><a href="#impl-PartialOrd%3CDate%3E-for-Date">PartialOrd&lt;Date&gt;</a></li><li><a href="#impl-Serialize-for-Date">Serialize</a></li><li><a href="#impl-StructuralEq-for-Date">StructuralEq</a></li><li><a href="#impl-StructuralPartialEq-for-Date">StructuralPartialEq</a></li><li><a href="#impl-Sub%3CDate%3E-for-Date">Sub&lt;Date&gt;</a></li><li><a href="#impl-Sub%3CDuration%3E-for-Date">Sub&lt;Duration&gt;</a></li><li><a href="#impl-Sub%3CDuration%3E-for-Date-1">Sub&lt;Duration&gt;</a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-Date">SubAssign&lt;Duration&gt;</a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-Date-1">SubAssign&lt;Duration&gt;</a></li><li><a href="#impl-TryFrom%3CParsed%3E-for-Date">TryFrom&lt;Parsed&gt;</a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block"><li><a href="#impl-RefUnwindSafe-for-Date">RefUnwindSafe</a></li><li><a href="#impl-Send-for-Date">Send</a></li><li><a href="#impl-Sync-for-Date">Sync</a></li><li><a href="#impl-Unpin-for-Date">Unpin</a></li><li><a href="#impl-UnwindSafe-for-Date">UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block"><li><a href="#impl-Any-for-Date">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-Date">Borrow&lt;T&gt;</a></li><li><a href="#impl-BorrowMut%3CT%3E-for-Date">BorrowMut&lt;T&gt;</a></li><li><a href="#impl-DeserializeOwned-for-Date">DeserializeOwned</a></li><li><a href="#impl-From%3CT%3E-for-Date">From&lt;T&gt;</a></li><li><a href="#impl-Into%3CU%3E-for-Date">Into&lt;U&gt;</a></li><li><a href="#impl-ToOwned-for-Date">ToOwned</a></li><li><a href="#impl-ToString-for-Date">ToString</a></li><li><a href="#impl-TryFrom%3CU%3E-for-Date">TryFrom&lt;U&gt;</a></li><li><a href="#impl-TryInto%3CU%3E-for-Date">TryInto&lt;U&gt;</a></li></ul></section><h2><a href="index.html">In time</a></h2></div></nav><main><div class="width-limiter"><nav class="sub"><form class="search-form"><div class="search-container"><span></span><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><div id="help-button" title="help" tabindex="-1"><a href="../help.html">?</a></div><div id="settings-menu" tabindex="-1"><a href="../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../wheel.svg"></a></div></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1 class="fqn">Struct <a href="index.html">time</a>::<wbr><a class="struct" href="#">Date</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/date.rs.html#36-43">source</a> · <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">&#x2212;</span>]</a></span></div><div class="item-decl"><pre class="rust struct"><code>pub struct Date { /* private fields */ }</code></pre></div><details class="rustdoc-toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Date in the proleptic Gregorian calendar.</p>
<p>By default, years between ±9999 inclusive are representable. This can be expanded to ±999,999
inclusive by enabling the <code>large-dates</code> crate feature. Doing so has performance implications
and introduces some ambiguities when parsing.</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-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#45-817">source</a><a href="#impl-Date" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedconstant.MIN" class="associatedconstant has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#49">source</a><h4 class="code-header">pub const <a href="#associatedconstant.MIN" class="constant">MIN</a>: Self = _</h4></section></summary><div class="docblock"><p>The minimum valid <code>Date</code>.</p>
<p>The value of this may vary depending on the feature flags enabled.</p>
</div></details><details class="rustdoc-toggle" open><summary><section id="associatedconstant.MAX" class="associatedconstant has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#54">source</a><h4 class="code-header">pub const <a href="#associatedconstant.MAX" class="constant">MAX</a>: Self = _</h4></section></summary><div class="docblock"><p>The maximum valid <code>Date</code>.</p>
<p>The value of this may vary depending on the feature flags enabled.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from_calendar_date" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#83-102">source</a><h4 class="code-header">pub const fn <a href="#method.from_calendar_date" class="fnname">from_calendar_date</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;year: i32,<br>&nbsp;&nbsp;&nbsp;&nbsp;month: <a class="enum" href="enum.Month.html" title="enum time::Month">Month</a>,<br>&nbsp;&nbsp;&nbsp;&nbsp;day: u8<br>) -&gt; Result&lt;Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</h4></section></summary><div class="docblock"><p>Attempt to create a <code>Date</code> from the year, month, and day.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(Date::from_calendar_date(<span class="number">2019</span>, Month::January, <span class="number">1</span>).is_ok());
<span class="macro">assert!</span>(Date::from_calendar_date(<span class="number">2019</span>, Month::December, <span class="number">31</span>).is_ok());</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%20Month%7D%3B%0Aassert!(Date%3A%3Afrom_calendar_date(2019%2C%20Month%3A%3AJanuary%2C%201).is_ok())%3B%0Aassert!(Date%3A%3Afrom_calendar_date(2019%2C%20Month%3A%3ADecember%2C%2031).is_ok())%3B%0A%7D&amp;edition=2021">Run</a></div>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(Date::from_calendar_date(<span class="number">2019</span>, Month::February, <span class="number">29</span>).is_err()); <span class="comment">// 2019 isn&#39;t a leap 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%3A%3A%7BDate%2C%20Month%7D%3B%0Aassert!(Date%3A%3Afrom_calendar_date(2019%2C%20Month%3A%3AFebruary%2C%2029).is_err())%3B%20%2F%2F%202019%20isn't%20a%20leap%20year.%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from_ordinal_date" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#116-120">source</a><h4 class="code-header">pub const fn <a href="#method.from_ordinal_date" class="fnname">from_ordinal_date</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;year: i32,<br>&nbsp;&nbsp;&nbsp;&nbsp;ordinal: u16<br>) -&gt; Result&lt;Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</h4></section></summary><div class="docblock"><p>Attempt to create a <code>Date</code> from the year and ordinal day number.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(Date::from_ordinal_date(<span class="number">2019</span>, <span class="number">1</span>).is_ok());
<span class="macro">assert!</span>(Date::from_ordinal_date(<span class="number">2019</span>, <span class="number">365</span>).is_ok());</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%3ADate%3B%0Aassert!(Date%3A%3Afrom_ordinal_date(2019%2C%201).is_ok())%3B%0Aassert!(Date%3A%3Afrom_ordinal_date(2019%2C%20365).is_ok())%3B%0A%7D&amp;edition=2021">Run</a></div>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(Date::from_ordinal_date(<span class="number">2019</span>, <span class="number">366</span>).is_err()); <span class="comment">// 2019 isn&#39;t a leap 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%3A%3ADate%3B%0Aassert!(Date%3A%3Afrom_ordinal_date(2019%2C%20366).is_err())%3B%20%2F%2F%202019%20isn't%20a%20leap%20year.%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from_iso_week_date" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#135-167">source</a><h4 class="code-header">pub const fn <a href="#method.from_iso_week_date" class="fnname">from_iso_week_date</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;year: i32,<br>&nbsp;&nbsp;&nbsp;&nbsp;week: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;weekday: <a class="enum" href="enum.Weekday.html" title="enum time::Weekday">Weekday</a><br>) -&gt; Result&lt;Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</h4></section></summary><div class="docblock"><p>Attempt to create a <code>Date</code> from the ISO year, week, and weekday.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(Date::from_iso_week_date(<span class="number">2019</span>, <span class="number">1</span>, Monday).is_ok());
<span class="macro">assert!</span>(Date::from_iso_week_date(<span class="number">2019</span>, <span class="number">1</span>, Tuesday).is_ok());
<span class="macro">assert!</span>(Date::from_iso_week_date(<span class="number">2020</span>, <span class="number">53</span>, Friday).is_ok());</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%20Weekday%3A%3A*%7D%3B%0Aassert!(Date%3A%3Afrom_iso_week_date(2019%2C%201%2C%20Monday).is_ok())%3B%0Aassert!(Date%3A%3Afrom_iso_week_date(2019%2C%201%2C%20Tuesday).is_ok())%3B%0Aassert!(Date%3A%3Afrom_iso_week_date(2020%2C%2053%2C%20Friday).is_ok())%3B%0A%7D&amp;edition=2021">Run</a></div>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(Date::from_iso_week_date(<span class="number">2019</span>, <span class="number">53</span>, Monday).is_err()); <span class="comment">// 2019 doesn&#39;t have 53 weeks.</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%20Weekday%3A%3A*%7D%3B%0Aassert!(Date%3A%3Afrom_iso_week_date(2019%2C%2053%2C%20Monday).is_err())%3B%20%2F%2F%202019%20doesn't%20have%2053%20weeks.%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from_julian_day" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#183-188">source</a><h4 class="code-header">pub const fn <a href="#method.from_julian_day" class="fnname">from_julian_day</a>(julian_day: i32) -&gt; Result&lt;Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</h4></section></summary><div class="docblock"><p>Create a <code>Date</code> from the Julian day.</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>(Date::from_julian_day(<span class="number">0</span>), <span class="prelude-val">Ok</span>(<span class="macro">date!</span>(-<span class="number">4713 </span>- <span class="number">11 </span>- <span class="number">24</span>)));
<span class="macro">assert_eq!</span>(Date::from_julian_day(<span class="number">2_451_545</span>), <span class="prelude-val">Ok</span>(<span class="macro">date!</span>(<span class="number">2000 </span>- <span class="number">01 </span>- <span class="number">01</span>)));
<span class="macro">assert_eq!</span>(Date::from_julian_day(<span class="number">2_458_485</span>), <span class="prelude-val">Ok</span>(<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>(Date::from_julian_day(<span class="number">2_458_849</span>), <span class="prelude-val">Ok</span>(<span class="macro">date!</span>(<span class="number">2019 </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%3A%3ADate%3B%0Ause%20time_macros%3A%3Adate%3B%0Aassert_eq!(Date%3A%3Afrom_julian_day(0)%2C%20Ok(date!(-4713%20-%2011%20-%2024)))%3B%0Aassert_eq!(Date%3A%3Afrom_julian_day(2_451_545)%2C%20Ok(date!(2000%20-%2001%20-%2001)))%3B%0Aassert_eq!(Date%3A%3Afrom_julian_day(2_458_485)%2C%20Ok(date!(2019%20-%2001%20-%2001)))%3B%0Aassert_eq!(Date%3A%3Afrom_julian_day(2_458_849)%2C%20Ok(date!(2019%20-%2012%20-%2031)))%3B%0A%7D&amp;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/date.rs.html#239-241">source</a><h4 class="code-header">pub const fn <a href="#method.year" class="fnname">year</a>(self) -&gt; i32</h4></section></summary><div class="docblock"><p>Get the year of the date.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).year(), <span class="number">2019</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">12 </span>- <span class="number">31</span>).year(), <span class="number">2019</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">01</span>).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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).year()%2C%202019)%3B%0Aassert_eq!(date!(2019%20-%2012%20-%2031).year()%2C%202019)%3B%0Aassert_eq!(date!(2020%20-%2001%20-%2001).year()%2C%202020)%3B%0A%7D&amp;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/date.rs.html#251-253">source</a><h4 class="code-header">pub const fn <a href="#method.month" class="fnname">month</a>(self) -&gt; <a class="enum" href="enum.Month.html" title="enum time::Month">Month</a></h4></section></summary><div class="docblock"><p>Get the month.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).month(), Month::January);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">12 </span>- <span class="number">31</span>).month(), Month::December);</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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).month()%2C%20Month%3A%3AJanuary)%3B%0Aassert_eq!(date!(2019%20-%2012%20-%2031).month()%2C%20Month%3A%3ADecember)%3B%0A%7D&amp;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/date.rs.html#264-266">source</a><h4 class="code-header">pub const fn <a href="#method.day" class="fnname">day</a>(self) -&gt; u8</h4></section></summary><div class="docblock"><p>Get the day of the month.</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">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).day(), <span class="number">1</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">12 </span>- <span class="number">31</span>).day(), <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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).day()%2C%201)%3B%0Aassert_eq!(date!(2019%20-%2012%20-%2031).day()%2C%2031)%3B%0A%7D&amp;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/date.rs.html#318-320">source</a><h4 class="code-header">pub const fn <a href="#method.ordinal" class="fnname">ordinal</a>(self) -&gt; u16</h4></section></summary><div class="docblock"><p>Get the day of the year.</p>
<p>The returned value will always be in the range <code>1..=366</code> (<code>1..=365</code> for common years).</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).ordinal(), <span class="number">1</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">12 </span>- <span class="number">31</span>).ordinal(), <span class="number">365</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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).ordinal()%2C%201)%3B%0Aassert_eq!(date!(2019%20-%2012%20-%2031).ordinal()%2C%20365)%3B%0A%7D&amp;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/date.rs.html#345-347">source</a><h4 class="code-header">pub const fn <a href="#method.iso_week" class="fnname">iso_week</a>(self) -&gt; u8</h4></section></summary><div class="docblock"><p>Get the ISO week number.</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">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).iso_week(), <span class="number">1</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">10 </span>- <span class="number">04</span>).iso_week(), <span class="number">40</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">01</span>).iso_week(), <span class="number">1</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).iso_week(), <span class="number">53</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2021 </span>- <span class="number">01 </span>- <span class="number">01</span>).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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).iso_week()%2C%201)%3B%0Aassert_eq!(date!(2019%20-%2010%20-%2004).iso_week()%2C%2040)%3B%0Aassert_eq!(date!(2020%20-%2001%20-%2001).iso_week()%2C%201)%3B%0Aassert_eq!(date!(2020%20-%2012%20-%2031).iso_week()%2C%2053)%3B%0Aassert_eq!(date!(2021%20-%2001%20-%2001).iso_week()%2C%2053)%3B%0A%7D&amp;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/date.rs.html#360-362">source</a><h4 class="code-header">pub const fn <a href="#method.sunday_based_week" class="fnname">sunday_based_week</a>(self) -&gt; 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">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).sunday_based_week(), <span class="number">0</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">01</span>).sunday_based_week(), <span class="number">0</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).sunday_based_week(), <span class="number">52</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2021 </span>- <span class="number">01 </span>- <span class="number">01</span>).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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).sunday_based_week()%2C%200)%3B%0Aassert_eq!(date!(2020%20-%2001%20-%2001).sunday_based_week()%2C%200)%3B%0Aassert_eq!(date!(2020%20-%2012%20-%2031).sunday_based_week()%2C%2052)%3B%0Aassert_eq!(date!(2021%20-%2001%20-%2001).sunday_based_week()%2C%200)%3B%0A%7D&amp;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/date.rs.html#375-377">source</a><h4 class="code-header">pub const fn <a href="#method.monday_based_week" class="fnname">monday_based_week</a>(self) -&gt; 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">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).monday_based_week(), <span class="number">0</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">01</span>).monday_based_week(), <span class="number">0</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).monday_based_week(), <span class="number">52</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2021 </span>- <span class="number">01 </span>- <span class="number">01</span>).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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).monday_based_week()%2C%200)%3B%0Aassert_eq!(date!(2020%20-%2001%20-%2001).monday_based_week()%2C%200)%3B%0Aassert_eq!(date!(2020%20-%2012%20-%2031).monday_based_week()%2C%2052)%3B%0Aassert_eq!(date!(2021%20-%2001%20-%2001).monday_based_week()%2C%200)%3B%0A%7D&amp;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/date.rs.html#389-392">source</a><h4 class="code-header">pub const fn <a href="#method.to_calendar_date" class="fnname">to_calendar_date</a>(self) -&gt; (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">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).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%3Adate%3B%0Aassert_eq!(%0A%20%20%20%20date!(2019%20-%2001%20-%2001).to_calendar_date()%2C%0A%20%20%20%20(2019%2C%20Month%3A%3AJanuary%2C%201)%0A)%3B%0A%7D&amp;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/date.rs.html#400-402">source</a><h4 class="code-header">pub const fn <a href="#method.to_ordinal_date" class="fnname">to_ordinal_date</a>(self) -&gt; (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">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).to_ordinal_date()%2C%20(2019%2C%201))%3B%0A%7D&amp;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/date.rs.html#421-430">source</a><h4 class="code-header">pub const fn <a href="#method.to_iso_week_date" class="fnname">to_iso_week_date</a>(self) -&gt; (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">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).to_iso_week_date(), (<span class="number">2019</span>, <span class="number">1</span>, Tuesday));
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">10 </span>- <span class="number">04</span>).to_iso_week_date(), (<span class="number">2019</span>, <span class="number">40</span>, Friday));
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">01</span>).to_iso_week_date(),
(<span class="number">2020</span>, <span class="number">1</span>, Wednesday)
);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).to_iso_week_date(),
(<span class="number">2020</span>, <span class="number">53</span>, Thursday)
);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2021 </span>- <span class="number">01 </span>- <span class="number">01</span>).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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).to_iso_week_date()%2C%20(2019%2C%201%2C%20Tuesday))%3B%0Aassert_eq!(date!(2019%20-%2010%20-%2004).to_iso_week_date()%2C%20(2019%2C%2040%2C%20Friday))%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2001%20-%2001).to_iso_week_date()%2C%0A%20%20%20%20(2020%2C%201%2C%20Wednesday)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).to_iso_week_date()%2C%0A%20%20%20%20(2020%2C%2053%2C%20Thursday)%0A)%3B%0Aassert_eq!(date!(2021%20-%2001%20-%2001).to_iso_week_date()%2C%20(2020%2C%2053%2C%20Friday))%3B%0A%7D&amp;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/date.rs.html#450-463">source</a><h4 class="code-header">pub const fn <a href="#method.weekday" class="fnname">weekday</a>(self) -&gt; <a class="enum" href="enum.Weekday.html" title="enum time::Weekday">Weekday</a></h4></section></summary><div class="docblock"><p>Get the weekday.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).weekday(), Tuesday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">02 </span>- <span class="number">01</span>).weekday(), Friday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">03 </span>- <span class="number">01</span>).weekday(), Friday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">04 </span>- <span class="number">01</span>).weekday(), Monday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">05 </span>- <span class="number">01</span>).weekday(), Wednesday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">06 </span>- <span class="number">01</span>).weekday(), Saturday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">07 </span>- <span class="number">01</span>).weekday(), Monday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">08 </span>- <span class="number">01</span>).weekday(), Thursday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">09 </span>- <span class="number">01</span>).weekday(), Sunday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">10 </span>- <span class="number">01</span>).weekday(), Tuesday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">11 </span>- <span class="number">01</span>).weekday(), Friday);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">12 </span>- <span class="number">01</span>).weekday(), Sunday);</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%3Adate%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).weekday()%2C%20Tuesday)%3B%0Aassert_eq!(date!(2019%20-%2002%20-%2001).weekday()%2C%20Friday)%3B%0Aassert_eq!(date!(2019%20-%2003%20-%2001).weekday()%2C%20Friday)%3B%0Aassert_eq!(date!(2019%20-%2004%20-%2001).weekday()%2C%20Monday)%3B%0Aassert_eq!(date!(2019%20-%2005%20-%2001).weekday()%2C%20Wednesday)%3B%0Aassert_eq!(date!(2019%20-%2006%20-%2001).weekday()%2C%20Saturday)%3B%0Aassert_eq!(date!(2019%20-%2007%20-%2001).weekday()%2C%20Monday)%3B%0Aassert_eq!(date!(2019%20-%2008%20-%2001).weekday()%2C%20Thursday)%3B%0Aassert_eq!(date!(2019%20-%2009%20-%2001).weekday()%2C%20Sunday)%3B%0Aassert_eq!(date!(2019%20-%2010%20-%2001).weekday()%2C%20Tuesday)%3B%0Aassert_eq!(date!(2019%20-%2011%20-%2001).weekday()%2C%20Friday)%3B%0Aassert_eq!(date!(2019%20-%2012%20-%2001).weekday()%2C%20Sunday)%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.next_day" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#484-496">source</a><h4 class="code-header">pub const fn <a href="#method.next_day" class="fnname">next_day</a>(self) -&gt; Option&lt;Self&gt;</h4></section></summary><div class="docblock"><p>Get the next calendar date.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).next_day(),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">02</span>))
);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">31</span>).next_day(),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">02 </span>- <span class="number">01</span>))
);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">12 </span>- <span class="number">31</span>).next_day(),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">01</span>))
);
<span class="macro">assert_eq!</span>(Date::MAX.next_day(), <span class="prelude-val">None</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%3ADate%3B%0Ause%20time_macros%3A%3Adate%3B%0Aassert_eq!(%0A%20%20%20%20date!(2019%20-%2001%20-%2001).next_day()%2C%0A%20%20%20%20Some(date!(2019%20-%2001%20-%2002))%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2019%20-%2001%20-%2031).next_day()%2C%0A%20%20%20%20Some(date!(2019%20-%2002%20-%2001))%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2019%20-%2012%20-%2031).next_day()%2C%0A%20%20%20%20Some(date!(2020%20-%2001%20-%2001))%0A)%3B%0Aassert_eq!(Date%3A%3AMAX.next_day()%2C%20None)%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.previous_day" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#517-530">source</a><h4 class="code-header">pub const fn <a href="#method.previous_day" class="fnname">previous_day</a>(self) -&gt; Option&lt;Self&gt;</h4></section></summary><div class="docblock"><p>Get the previous calendar date.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">02</span>).previous_day(),
<span class="prelude-val">Some</span>(<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">date!</span>(<span class="number">2019 </span>- <span class="number">02 </span>- <span class="number">01</span>).previous_day(),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">31</span>))
);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">01</span>).previous_day(),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">12 </span>- <span class="number">31</span>))
);
<span class="macro">assert_eq!</span>(Date::MIN.previous_day(), <span class="prelude-val">None</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%3ADate%3B%0Ause%20time_macros%3A%3Adate%3B%0Aassert_eq!(%0A%20%20%20%20date!(2019%20-%2001%20-%2002).previous_day()%2C%0A%20%20%20%20Some(date!(2019%20-%2001%20-%2001))%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2019%20-%2002%20-%2001).previous_day()%2C%0A%20%20%20%20Some(date!(2019%20-%2001%20-%2031))%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2001%20-%2001).previous_day()%2C%0A%20%20%20%20Some(date!(2019%20-%2012%20-%2031))%0A)%3B%0Aassert_eq!(Date%3A%3AMIN.previous_day()%2C%20None)%3B%0A%7D&amp;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/date.rs.html#544-551">source</a><h4 class="code-header">pub const fn <a href="#method.to_julian_day" class="fnname">to_julian_day</a>(self) -&gt; i32</h4></section></summary><div class="docblock"><p>Get the Julian day for the date.</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">date!</span>(-<span class="number">4713 </span>- <span class="number">11 </span>- <span class="number">24</span>).to_julian_day(), <span class="number">0</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2000 </span>- <span class="number">01 </span>- <span class="number">01</span>).to_julian_day(), <span class="number">2_451_545</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">01 </span>- <span class="number">01</span>).to_julian_day(), <span class="number">2_458_485</span>);
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">12 </span>- <span class="number">31</span>).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%3Adate%3B%0Aassert_eq!(date!(-4713%20-%2011%20-%2024).to_julian_day()%2C%200)%3B%0Aassert_eq!(date!(2000%20-%2001%20-%2001).to_julian_day()%2C%202_451_545)%3B%0Aassert_eq!(date!(2019%20-%2001%20-%2001).to_julian_day()%2C%202_458_485)%3B%0Aassert_eq!(date!(2019%20-%2012%20-%2031).to_julian_day()%2C%202_458_849)%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.checked_add" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#586-598">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>) -&gt; Option&lt;Self&gt;</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="macro">assert_eq!</span>(Date::MAX.checked_add(<span class="number">1</span>.days()), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(Date::MIN.checked_add((-<span class="number">2</span>).days()), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).checked_add(<span class="number">2</span>.days()),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2021 </span>- <span class="number">01 </span>- <span class="number">02</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%3Adate%3B%0Aassert_eq!(Date%3A%3AMAX.checked_add(1.days())%2C%20None)%3B%0Aassert_eq!(Date%3A%3AMIN.checked_add((-2).days())%2C%20None)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).checked_add(2.days())%2C%0A%20%20%20%20Some(date!(2021%20-%2001%20-%2002))%0A)%3B%0A%7D&amp;edition=2021">Run</a></div>
<h5 id="note"><a href="#note">Note</a></h5>
<p>This function only takes whole days into account.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(Date::MAX.checked_add(<span class="number">23</span>.hours()), <span class="prelude-val">Some</span>(Date::MAX));
<span class="macro">assert_eq!</span>(Date::MIN.checked_add((-<span class="number">23</span>).hours()), <span class="prelude-val">Some</span>(Date::MIN));
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).checked_add(<span class="number">23</span>.hours()),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>))
);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).checked_add(<span class="number">47</span>.hours()),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2021 </span>- <span class="number">01 </span>- <span class="number">01</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%3Adate%3B%0Aassert_eq!(Date%3A%3AMAX.checked_add(23.hours())%2C%20Some(Date%3A%3AMAX))%3B%0Aassert_eq!(Date%3A%3AMIN.checked_add((-23).hours())%2C%20Some(Date%3A%3AMIN))%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).checked_add(23.hours())%2C%0A%20%20%20%20Some(date!(2020%20-%2012%20-%2031))%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).checked_add(47.hours())%2C%0A%20%20%20%20Some(date!(2021%20-%2001%20-%2001))%0A)%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.checked_sub" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#631-643">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>) -&gt; Option&lt;Self&gt;</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="macro">assert_eq!</span>(Date::MAX.checked_sub((-<span class="number">2</span>).days()), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(Date::MIN.checked_sub(<span class="number">1</span>.days()), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).checked_sub(<span class="number">2</span>.days()),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <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%3A%3A%7BDate%2C%20ext%3A%3ANumericalDuration%7D%3B%0Ause%20time_macros%3A%3Adate%3B%0Aassert_eq!(Date%3A%3AMAX.checked_sub((-2).days())%2C%20None)%3B%0Aassert_eq!(Date%3A%3AMIN.checked_sub(1.days())%2C%20None)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).checked_sub(2.days())%2C%0A%20%20%20%20Some(date!(2020%20-%2012%20-%2029))%0A)%3B%0A%7D&amp;edition=2021">Run</a></div>
<h5 id="note-1"><a href="#note-1">Note</a></h5>
<p>This function only takes whole days into account.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(Date::MAX.checked_sub((-<span class="number">23</span>).hours()), <span class="prelude-val">Some</span>(Date::MAX));
<span class="macro">assert_eq!</span>(Date::MIN.checked_sub(<span class="number">23</span>.hours()), <span class="prelude-val">Some</span>(Date::MIN));
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).checked_sub(<span class="number">23</span>.hours()),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>))
);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).checked_sub(<span class="number">47</span>.hours()),
<span class="prelude-val">Some</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">30</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%3Adate%3B%0Aassert_eq!(Date%3A%3AMAX.checked_sub((-23).hours())%2C%20Some(Date%3A%3AMAX))%3B%0Aassert_eq!(Date%3A%3AMIN.checked_sub(23.hours())%2C%20Some(Date%3A%3AMIN))%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).checked_sub(23.hours())%2C%0A%20%20%20%20Some(date!(2020%20-%2012%20-%2031))%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).checked_sub(47.hours())%2C%0A%20%20%20%20Some(date!(2020%20-%2012%20-%2030))%0A)%3B%0A%7D&amp;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/date.rs.html#676-685">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>) -&gt; 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>(Date::MAX.saturating_add(<span class="number">1</span>.days()), Date::MAX);
<span class="macro">assert_eq!</span>(Date::MIN.saturating_add((-<span class="number">2</span>).days()), Date::MIN);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).saturating_add(<span class="number">2</span>.days()),
<span class="macro">date!</span>(<span class="number">2021 </span>- <span class="number">01 </span>- <span class="number">02</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%3Adate%3B%0Aassert_eq!(Date%3A%3AMAX.saturating_add(1.days())%2C%20Date%3A%3AMAX)%3B%0Aassert_eq!(Date%3A%3AMIN.saturating_add((-2).days())%2C%20Date%3A%3AMIN)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).saturating_add(2.days())%2C%0A%20%20%20%20date!(2021%20-%2001%20-%2002)%0A)%3B%0A%7D&amp;edition=2021">Run</a></div>
<h5 id="note-2"><a href="#note-2">Note</a></h5>
<p>This function only takes whole days into account.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).saturating_add(<span class="number">23</span>.hours()),
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>)
);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).saturating_add(<span class="number">47</span>.hours()),
<span class="macro">date!</span>(<span class="number">2021 </span>- <span class="number">01 </span>- <span class="number">01</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%3Adate%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).saturating_add(23.hours())%2C%0A%20%20%20%20date!(2020%20-%2012%20-%2031)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).saturating_add(47.hours())%2C%0A%20%20%20%20date!(2021%20-%2001%20-%2001)%0A)%3B%0A%7D&amp;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/date.rs.html#716-725">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>) -&gt; 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>(Date::MAX.saturating_sub((-<span class="number">2</span>).days()), Date::MAX);
<span class="macro">assert_eq!</span>(Date::MIN.saturating_sub(<span class="number">1</span>.days()), Date::MIN);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).saturating_sub(<span class="number">2</span>.days()),
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <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%3A%3A%7BDate%2C%20ext%3A%3ANumericalDuration%7D%3B%0Ause%20time_macros%3A%3Adate%3B%0Aassert_eq!(Date%3A%3AMAX.saturating_sub((-2).days())%2C%20Date%3A%3AMAX)%3B%0Aassert_eq!(Date%3A%3AMIN.saturating_sub(1.days())%2C%20Date%3A%3AMIN)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).saturating_sub(2.days())%2C%0A%20%20%20%20date!(2020%20-%2012%20-%2029)%0A)%3B%0A%7D&amp;edition=2021">Run</a></div>
<h5 id="note-3"><a href="#note-3">Note</a></h5>
<p>This function only takes whole days into account.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).saturating_sub(<span class="number">23</span>.hours()),
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>)
);
<span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">31</span>).saturating_sub(<span class="number">47</span>.hours()),
<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">12 </span>- <span class="number">30</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%3Adate%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).saturating_sub(23.hours())%2C%0A%20%20%20%20date!(2020%20-%2012%20-%2031)%0A)%3B%0Aassert_eq!(%0A%20%20%20%20date!(2020%20-%2012%20-%2031).saturating_sub(47.hours())%2C%0A%20%20%20%20date!(2020%20-%2012%20-%2030)%0A)%3B%0A%7D&amp;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/date.rs.html#741-768">source</a><h4 class="code-header">pub const fn <a href="#method.replace_year" class="fnname">replace_year</a>(self, year: i32) -&gt; Result&lt;Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</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">date!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18</span>).replace_year(<span class="number">2019</span>),
<span class="prelude-val">Ok</span>(<span class="macro">date!</span>(<span class="number">2019 </span>- <span class="number">02 </span>- <span class="number">18</span>))
);
<span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18</span>).replace_year(-<span class="number">1_000_000_000</span>).is_err()); <span class="comment">// -1_000_000_000 isn&#39;t a valid year
</span><span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18</span>).replace_year(<span class="number">1_000_000_000</span>).is_err()); <span class="comment">// 1_000_000_000 isn&#39;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%3Adate%3B%0Aassert_eq!(%0A%20%20%20%20date!(2022%20-%2002%20-%2018).replace_year(2019)%2C%0A%20%20%20%20Ok(date!(2019%20-%2002%20-%2018))%0A)%3B%0Aassert!(date!(2022%20-%2002%20-%2018).replace_year(-1_000_000_000).is_err())%3B%20%2F%2F%20-1_000_000_000%20isn't%20a%20valid%20year%0Aassert!(date!(2022%20-%2002%20-%2018).replace_year(1_000_000_000).is_err())%3B%20%2F%2F%201_000_000_000%20isn't%20a%20valid%20year%0A%7D&amp;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/date.rs.html#786-789">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>) -&gt; Result&lt;Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</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">date!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18</span>).replace_month(Month::January),
<span class="prelude-val">Ok</span>(<span class="macro">date!</span>(<span class="number">2022 </span>- <span class="number">01 </span>- <span class="number">18</span>))
);
<span class="macro">assert!</span>(
<span class="macro">date!</span>(<span class="number">2022 </span>- <span class="number">01 </span>- <span class="number">30</span>)
.replace_month(Month::February)
.is_err()
); <span class="comment">// 30 isn&#39;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%3Adate%3B%0Ause%20time%3A%3AMonth%3B%0Aassert_eq!(%0A%20%20%20%20date!(2022%20-%2002%20-%2018).replace_month(Month%3A%3AJanuary)%2C%0A%20%20%20%20Ok(date!(2022%20-%2001%20-%2018))%0A)%3B%0Aassert!(%0A%20%20%20%20date!(2022%20-%2001%20-%2030)%0A%20%20%20%20%20%20%20%20.replace_month(Month%3A%3AFebruary)%0A%20%20%20%20%20%20%20%20.is_err()%0A)%3B%20%2F%2F%2030%20isn't%20a%20valid%20day%20in%20February%0A%7D&amp;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/date.rs.html#803-815">source</a><h4 class="code-header">pub const fn <a href="#method.replace_day" class="fnname">replace_day</a>(self, day: u8) -&gt; Result&lt;Self, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</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">date!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18</span>).replace_day(<span class="number">1</span>),
<span class="prelude-val">Ok</span>(<span class="macro">date!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">01</span>))
);
<span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18</span>).replace_day(<span class="number">0</span>).is_err()); <span class="comment">// 0 isn&#39;t a valid day
</span><span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">2022 </span>- <span class="number">02 </span>- <span class="number">18</span>).replace_day(<span class="number">30</span>).is_err()); <span class="comment">// 30 isn&#39;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%3Adate%3B%0Aassert_eq!(%0A%20%20%20%20date!(2022%20-%2002%20-%2018).replace_day(1)%2C%0A%20%20%20%20Ok(date!(2022%20-%2002%20-%2001))%0A)%3B%0Aassert!(date!(2022%20-%2002%20-%2018).replace_day(0).is_err())%3B%20%2F%2F%200%20isn't%20a%20valid%20day%0Aassert!(date!(2022%20-%2002%20-%2018).replace_day(30).is_err())%3B%20%2F%2F%2030%20isn't%20a%20valid%20day%20in%20February%0A%7D&amp;edition=2021">Run</a></div>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Date-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#821-924">source</a><a href="#impl-Date-1" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section></summary><div class="docblock"><p>Methods to add a <a href="struct.Time.html" title="Time"><code>Time</code></a> component, resulting in a <a href="struct.PrimitiveDateTime.html" title="PrimitiveDateTime"><code>PrimitiveDateTime</code></a>.</p>
</div><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.midnight" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#829-831">source</a><h4 class="code-header">pub const fn <a href="#method.midnight" class="fnname">midnight</a>(self) -&gt; <a class="struct" href="struct.PrimitiveDateTime.html" title="struct time::PrimitiveDateTime">PrimitiveDateTime</a></h4></section></summary><div class="docblock"><p>Create a <a href="struct.PrimitiveDateTime.html" title="PrimitiveDateTime"><code>PrimitiveDateTime</code></a> using the existing date. The <a href="struct.Time.html" title="Time"><code>Time</code></a> component will be set
to midnight.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">1970</span>-<span class="number">01</span>-<span class="number">01</span>).midnight(), <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>));</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%7D%3B%0Aassert_eq!(date!(1970-01-01).midnight()%2C%20datetime!(1970-01-01%200%3A00))%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_time" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#842-844">source</a><h4 class="code-header">pub const fn <a href="#method.with_time" class="fnname">with_time</a>(self, time: <a class="struct" href="struct.Time.html" title="struct time::Time">Time</a>) -&gt; <a class="struct" href="struct.PrimitiveDateTime.html" title="struct time::PrimitiveDateTime">PrimitiveDateTime</a></h4></section></summary><div class="docblock"><p>Create a <a href="struct.PrimitiveDateTime.html" title="PrimitiveDateTime"><code>PrimitiveDateTime</code></a> using the existing date and the provided <a href="struct.Time.html" title="Time"><code>Time</code></a>.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
<span class="macro">date!</span>(<span class="number">1970</span>-<span class="number">01</span>-<span class="number">01</span>).with_time(<span class="macro">time!</span>(<span class="number">0</span>:<span class="number">00</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>),
);</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%20time%7D%3B%0Aassert_eq!(%0A%20%20%20%20date!(1970-01-01).with_time(time!(0%3A00))%2C%0A%20%20%20%20datetime!(1970-01-01%200%3A00)%2C%0A)%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_hms" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#853-863">source</a><h4 class="code-header">pub const fn <a href="#method.with_hms" class="fnname">with_hms</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;self,<br>&nbsp;&nbsp;&nbsp;&nbsp;hour: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;minute: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;second: u8<br>) -&gt; Result&lt;<a class="struct" href="struct.PrimitiveDateTime.html" title="struct time::PrimitiveDateTime">PrimitiveDateTime</a>, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</h4></section></summary><div class="docblock"><p>Attempt to create a <a href="struct.PrimitiveDateTime.html" title="PrimitiveDateTime"><code>PrimitiveDateTime</code></a> using the existing date and the provided time.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">1970 </span>- <span class="number">01 </span>- <span class="number">01</span>).with_hms(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).is_ok());
<span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">1970 </span>- <span class="number">01 </span>- <span class="number">01</span>).with_hms(<span class="number">24</span>, <span class="number">0</span>, <span class="number">0</span>).is_err());</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%3Adate%3B%0Aassert!(date!(1970%20-%2001%20-%2001).with_hms(0%2C%200%2C%200).is_ok())%3B%0Aassert!(date!(1970%20-%2001%20-%2001).with_hms(24%2C%200%2C%200).is_err())%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_hms_milli" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#872-883">source</a><h4 class="code-header">pub const fn <a href="#method.with_hms_milli" class="fnname">with_hms_milli</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;self,<br>&nbsp;&nbsp;&nbsp;&nbsp;hour: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;minute: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;second: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;millisecond: u16<br>) -&gt; Result&lt;<a class="struct" href="struct.PrimitiveDateTime.html" title="struct time::PrimitiveDateTime">PrimitiveDateTime</a>, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</h4></section></summary><div class="docblock"><p>Attempt to create a <a href="struct.PrimitiveDateTime.html" title="PrimitiveDateTime"><code>PrimitiveDateTime</code></a> using the existing date and the provided time.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">1970 </span>- <span class="number">01 </span>- <span class="number">01</span>).with_hms_milli(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).is_ok());
<span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">1970 </span>- <span class="number">01 </span>- <span class="number">01</span>).with_hms_milli(<span class="number">24</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).is_err());</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%3Adate%3B%0Aassert!(date!(1970%20-%2001%20-%2001).with_hms_milli(0%2C%200%2C%200%2C%200).is_ok())%3B%0Aassert!(date!(1970%20-%2001%20-%2001).with_hms_milli(24%2C%200%2C%200%2C%200).is_err())%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_hms_micro" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#892-903">source</a><h4 class="code-header">pub const fn <a href="#method.with_hms_micro" class="fnname">with_hms_micro</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;self,<br>&nbsp;&nbsp;&nbsp;&nbsp;hour: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;minute: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;second: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;microsecond: u32<br>) -&gt; Result&lt;<a class="struct" href="struct.PrimitiveDateTime.html" title="struct time::PrimitiveDateTime">PrimitiveDateTime</a>, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</h4></section></summary><div class="docblock"><p>Attempt to create a <a href="struct.PrimitiveDateTime.html" title="PrimitiveDateTime"><code>PrimitiveDateTime</code></a> using the existing date and the provided time.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">1970 </span>- <span class="number">01 </span>- <span class="number">01</span>).with_hms_micro(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).is_ok());
<span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">1970 </span>- <span class="number">01 </span>- <span class="number">01</span>).with_hms_micro(<span class="number">24</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).is_err());</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%3Adate%3B%0Aassert!(date!(1970%20-%2001%20-%2001).with_hms_micro(0%2C%200%2C%200%2C%200).is_ok())%3B%0Aassert!(date!(1970%20-%2001%20-%2001).with_hms_micro(24%2C%200%2C%200%2C%200).is_err())%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_hms_nano" class="method has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#912-923">source</a><h4 class="code-header">pub const fn <a href="#method.with_hms_nano" class="fnname">with_hms_nano</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;self,<br>&nbsp;&nbsp;&nbsp;&nbsp;hour: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;minute: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;second: u8,<br>&nbsp;&nbsp;&nbsp;&nbsp;nanosecond: u32<br>) -&gt; Result&lt;<a class="struct" href="struct.PrimitiveDateTime.html" title="struct time::PrimitiveDateTime">PrimitiveDateTime</a>, <a class="struct" href="error/struct.ComponentRange.html" title="struct time::error::ComponentRange">ComponentRange</a>&gt;</h4></section></summary><div class="docblock"><p>Attempt to create a <a href="struct.PrimitiveDateTime.html" title="PrimitiveDateTime"><code>PrimitiveDateTime</code></a> using the existing date and the provided time.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">1970 </span>- <span class="number">01 </span>- <span class="number">01</span>).with_hms_nano(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).is_ok());
<span class="macro">assert!</span>(<span class="macro">date!</span>(<span class="number">1970 </span>- <span class="number">01 </span>- <span class="number">01</span>).with_hms_nano(<span class="number">24</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).is_err());</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%3Adate%3B%0Aassert!(date!(1970%20-%2001%20-%2001).with_hms_nano(0%2C%200%2C%200%2C%200).is_ok())%3B%0Aassert!(date!(1970%20-%2001%20-%2001).with_hms_nano(24%2C%200%2C%200%2C%200).is_err())%3B%0A%7D&amp;edition=2021">Run</a></div>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Date-2" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#929-951">source</a><a href="#impl-Date-2" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#931-937">source</a><h4 class="code-header">pub fn <a href="#method.format_into" class="fnname">format_into</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;self,<br>&nbsp;&nbsp;&nbsp;&nbsp;output: &amp;mut impl Write,<br>&nbsp;&nbsp;&nbsp;&nbsp;format: &amp;impl <a class="trait" href="formatting/trait.Formattable.html" title="trait time::formatting::Formattable">Formattable</a> + ?Sized<br>) -&gt; Result&lt;usize, <a class="enum" href="error/enum.Format.html" title="enum time::error::Format">Format</a>&gt;</h4></section></summary><div class="docblock"><p>Format the <code>Date</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/date.rs.html#948-950">source</a><h4 class="code-header">pub fn <a href="#method.format" class="fnname">format</a>(self, format: &amp;impl <a class="trait" href="formatting/trait.Formattable.html" title="trait time::formatting::Formattable">Formattable</a> + ?Sized) -&gt; Result&lt;String, <a class="enum" href="error/enum.Format.html" title="enum time::error::Format">Format</a>&gt;</h4></section></summary><div class="docblock"><p>Format the <code>Date</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">&quot;[year]-[month]-[day]&quot;</span>)<span class="question-mark">?</span>;
<span class="macro">assert_eq!</span>(<span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">02</span>).format(<span class="kw-2">&amp;</span>format)<span class="question-mark">?</span>, <span class="string">&quot;2020-01-02&quot;</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%3A%7Bformat_description%7D%3B%0Ause%20time_macros%3A%3Adate%3B%0Alet%20format%20%3D%20format_description%3A%3Aparse(%22%5Byear%5D-%5Bmonth%5D-%5Bday%5D%22)%3F%3B%0Aassert_eq!(date!(2020%20-%2001%20-%2002).format(%26format)%3F%2C%20%222020-01-02%22)%3B%0AOk%3A%3A%3C_%2C%20time%3A%3AError%3E(())%0A%7D%20_inner().unwrap()%20%7D&amp;edition=2021">Run</a></div>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Date-3" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#954-971">source</a><a href="#impl-Date-3" class="anchor"></a><h3 class="code-header">impl <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#965-970">source</a><h4 class="code-header">pub fn <a href="#method.parse" class="fnname">parse</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;input: &amp;str,<br>&nbsp;&nbsp;&nbsp;&nbsp;description: &amp;impl <a class="trait" href="parsing/trait.Parsable.html" title="trait time::parsing::Parsable">Parsable</a> + ?Sized<br>) -&gt; Result&lt;Self, <a class="enum" href="error/enum.Parse.html" title="enum time::error::Parse">Parse</a>&gt;</h4></section></summary><div class="docblock"><p>Parse a <code>Date</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">&quot;[year]-[month]-[day]&quot;</span>);
<span class="macro">assert_eq!</span>(Date::parse(<span class="string">&quot;2020-01-02&quot;</span>, <span class="kw-2">&amp;</span>format)<span class="question-mark">?</span>, <span class="macro">date!</span>(<span class="number">2020 </span>- <span class="number">01 </span>- <span class="number">02</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%3ADate%3B%0Ause%20time_macros%3A%3A%7Bdate%2C%20format_description%7D%3B%0Alet%20format%20%3D%20format_description!(%22%5Byear%5D-%5Bmonth%5D-%5Bday%5D%22)%3B%0Aassert_eq!(Date%3A%3Aparse(%222020-01-02%22%2C%20%26format)%3F%2C%20date!(2020%20-%2001%20-%2002))%3B%0AOk%3A%3A%3C_%2C%20time%3A%3AError%3E(())%0A%7D%20_inner().unwrap()%20%7D&amp;edition=2021">Run</a></div>
</div></details></div></details></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Add%3CDuration%3E-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1004-1011">source</a><a href="#impl-Add%3CDuration%3E-for-Date" class="anchor"></a><h3 class="code-header">impl Add&lt;<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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.Date.html" title="struct time::Date">Date</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/date.rs.html#1007-1010">source</a><a href="#method.add" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add</a>(self, duration: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -&gt; Self::Output</h4></section></summary><div class='docblock'>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-Date-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1013-1022">source</a><a href="#impl-Add%3CDuration%3E-for-Date-1" class="anchor"></a><h3 class="code-header">impl Add&lt;Duration&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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.Date.html" title="struct time::Date">Date</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/date.rs.html#1016-1021">source</a><a href="#method.add-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add</a>(self, duration: StdDuration) -&gt; Self::Output</h4></section></summary><div class='docblock'>Performs the <code>+</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-AddAssign%3CDuration%3E-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1024">source</a><a href="#impl-AddAssign%3CDuration%3E-for-Date" class="anchor"></a><h3 class="code-header">impl AddAssign&lt;<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#1024">source</a><a href="#method.add_assign" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add_assign</a>(&amp;mut self, rhs: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>)</h4></section></summary><div class='docblock'>Performs the <code>+=</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-AddAssign%3CDuration%3E-for-Date-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1024">source</a><a href="#impl-AddAssign%3CDuration%3E-for-Date-1" class="anchor"></a><h3 class="code-header">impl AddAssign&lt;Duration&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#1024">source</a><a href="#method.add_assign-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">add_assign</a>(&amp;mut self, rhs: StdDuration)</h4></section></summary><div class='docblock'>Performs the <code>+=</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Clone-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-Clone-for-Date" class="anchor"></a><h3 class="code-header">impl Clone for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#35">source</a><a href="#method.clone" class="anchor"></a><h4 class="code-header">fn <a class="fnname">clone</a>(&amp;self) -&gt; <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h4></section></summary><div class='docblock'>Returns a copy of the value. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone_from" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.clone_from" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">clone_from</a>(&amp;mut self, source: &amp;Self)</h4></section></summary><div class='docblock'>Performs copy-assignment from <code>source</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Debug-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#996-1000">source</a><a href="#impl-Debug-for-Date" class="anchor"></a><h3 class="code-header">impl Debug for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#997-999">source</a><a href="#method.fmt-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">fmt</a>(&amp;self, f: &amp;mut Formatter&lt;'_&gt;) -&gt; Result&lt;(), Error&gt;</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-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/serde/mod.rs.html#237-245">source</a><a href="#impl-Deserialize%3C%27a%3E-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;'a&gt; <a class="trait" href="../serde/de/trait.Deserialize.html" title="trait serde::de::Deserialize">Deserialize</a>&lt;'a&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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#238-244">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>&lt;D:&nbsp;<a class="trait" href="../serde/de/trait.Deserializer.html" title="trait serde::de::Deserializer">Deserializer</a>&lt;'a&gt;&gt;(deserializer: D) -&gt; Result&lt;Self, D::<a class="associatedtype" href="../serde/de/trait.Deserializer.html#associatedtype.Error" title="type serde::de::Deserializer::Error">Error</a>&gt;</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-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#973-994">source</a><a href="#impl-Display-for-Date" class="anchor"></a><h3 class="code-header">impl Display for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#974-993">source</a><a href="#method.fmt" class="anchor"></a><h4 class="code-header">fn <a class="fnname">fmt</a>(&amp;self, f: &amp;mut Formatter&lt;'_&gt;) -&gt; Result</h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Hash-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-Hash-for-Date" class="anchor"></a><h3 class="code-header">impl Hash for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#35">source</a><a href="#method.hash" class="anchor"></a><h4 class="code-header">fn <a class="fnname">hash</a>&lt;__H:&nbsp;Hasher&gt;(&amp;self, state: &amp;mut __H)</h4></section></summary><div class='docblock'>Feeds this value into the given [<code>Hasher</code>]. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.hash_slice" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.3.0">1.3.0</span><a href="#method.hash_slice" class="anchor"></a><h4 class="code-header">fn <a class="fnname">hash_slice</a>&lt;H&gt;(data: &amp;[Self], state: &amp;mut H)<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;H: Hasher,</span></h4></section></summary><div class='docblock'>Feeds a slice of this type into the given [<code>Hasher</code>]. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Ord-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-Ord-for-Date" class="anchor"></a><h3 class="code-header">impl Ord for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#35">source</a><a href="#method.cmp" class="anchor"></a><h4 class="code-header">fn <a class="fnname">cmp</a>(&amp;self, other: &amp;<a class="struct" href="struct.Date.html" title="struct time::Date">Date</a>) -&gt; Ordering</h4></section></summary><div class='docblock'>This method returns an [<code>Ordering</code>] between <code>self</code> and <code>other</code>. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.max" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.21.0">1.21.0</span><a href="#method.max" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">max</a>(self, other: Self) -&gt; Self</h4></section></summary><div class='docblock'>Compares and returns the maximum of two values. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.min" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.21.0">1.21.0</span><a href="#method.min" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">min</a>(self, other: Self) -&gt; Self</h4></section></summary><div class='docblock'>Compares and returns the minimum of two values. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clamp" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.50.0">1.50.0</span><a href="#method.clamp" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">clamp</a>(self, min: Self, max: Self) -&gt; Self<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;Self: PartialOrd&lt;Self&gt;,</span></h4></section></summary><div class='docblock'>Restrict a value to a certain interval. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialEq%3CDate%3E-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-PartialEq%3CDate%3E-for-Date" class="anchor"></a><h3 class="code-header">impl PartialEq&lt;<a class="struct" href="struct.Date.html" title="struct time::Date">Date</a>&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#35">source</a><a href="#method.eq" class="anchor"></a><h4 class="code-header">fn <a class="fnname">eq</a>(&amp;self, other: &amp;<a class="struct" href="struct.Date.html" title="struct time::Date">Date</a>) -&gt; bool</h4></section></summary><div class='docblock'>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
by <code>==</code>. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ne" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.ne" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">ne</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests for <code>!=</code>. The default implementation is almost always
sufficient, and should not be overridden without very good reason. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-PartialOrd%3CDate%3E-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-PartialOrd%3CDate%3E-for-Date" class="anchor"></a><h3 class="code-header">impl PartialOrd&lt;<a class="struct" href="struct.Date.html" title="struct time::Date">Date</a>&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#35">source</a><a href="#method.partial_cmp" class="anchor"></a><h4 class="code-header">fn <a class="fnname">partial_cmp</a>(&amp;self, other: &amp;<a class="struct" href="struct.Date.html" title="struct time::Date">Date</a>) -&gt; Option&lt;Ordering&gt;</h4></section></summary><div class='docblock'>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.lt" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.lt" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">lt</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code>&lt;</code> operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.le" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.le" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">le</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>&lt;=</code>
operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.gt" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.gt" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">gt</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>&gt;</code> operator. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ge" class="method trait-impl has-srclink"><span class="since rightside" title="Stable since Rust version 1.0.0">1.0.0</span><a href="#method.ge" class="anchor"></a><h4 class="code-header">const fn <a class="fnname">ge</a>(&amp;self, other: &amp;Rhs) -&gt; bool</h4></section></summary><div class='docblock'>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>&gt;=</code>
operator. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Serialize-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/serde/mod.rs.html#223-235">source</a><a href="#impl-Serialize-for-Date" 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.Date.html" title="struct time::Date">Date</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#224-234">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>&lt;S:&nbsp;<a class="trait" href="../serde/ser/trait.Serializer.html" title="trait serde::ser::Serializer">Serializer</a>&gt;(&amp;self, serializer: S) -&gt; Result&lt;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>&gt;</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%3CDate%3E-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1048-1054">source</a><a href="#impl-Sub%3CDate%3E-for-Date" class="anchor"></a><h3 class="code-header">impl Sub&lt;<a class="struct" href="struct.Date.html" title="struct time::Date">Date</a>&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#1051-1053">source</a><a href="#method.sub-2" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, other: Self) -&gt; Self::Output</h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Sub%3CDuration%3E-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1026-1033">source</a><a href="#impl-Sub%3CDuration%3E-for-Date" class="anchor"></a><h3 class="code-header">impl Sub&lt;<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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.Date.html" title="struct time::Date">Date</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/date.rs.html#1029-1032">source</a><a href="#method.sub" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, duration: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>) -&gt; Self::Output</h4></section></summary><div class='docblock'>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-Date-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1035-1044">source</a><a href="#impl-Sub%3CDuration%3E-for-Date-1" class="anchor"></a><h3 class="code-header">impl Sub&lt;Duration&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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.Date.html" title="struct time::Date">Date</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/date.rs.html#1038-1043">source</a><a href="#method.sub-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub</a>(self, duration: StdDuration) -&gt; Self::Output</h4></section></summary><div class='docblock'>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-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1046">source</a><a href="#impl-SubAssign%3CDuration%3E-for-Date" class="anchor"></a><h3 class="code-header">impl SubAssign&lt;<a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#1046">source</a><a href="#method.sub_assign" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub_assign</a>(&amp;mut self, rhs: <a class="struct" href="struct.Duration.html" title="struct time::Duration">Duration</a>)</h4></section></summary><div class='docblock'>Performs the <code>-=</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-SubAssign%3CDuration%3E-for-Date-1" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#1046">source</a><a href="#impl-SubAssign%3CDuration%3E-for-Date-1" class="anchor"></a><h3 class="code-header">impl SubAssign&lt;Duration&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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/date.rs.html#1046">source</a><a href="#method.sub_assign-1" class="anchor"></a><h4 class="code-header">fn <a class="fnname">sub_assign</a>(&amp;mut self, rhs: StdDuration)</h4></section></summary><div class='docblock'>Performs the <code>-=</code> operation. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-TryFrom%3CParsed%3E-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/parsing/parsed.rs.html#664-722">source</a><a href="#impl-TryFrom%3CParsed%3E-for-Date" class="anchor"></a><h3 class="code-header">impl TryFrom&lt;<a class="struct" href="parsing/struct.Parsed.html" title="struct time::parsing::Parsed">Parsed</a>&gt; for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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> = <a class="enum" href="error/enum.TryFromParsed.html" title="enum time::error::TryFromParsed">TryFromParsed</a></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#667-721">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>) -&gt; Result&lt;Self, Self::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><section id="impl-Copy-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-Copy-for-Date" class="anchor"></a><h3 class="code-header">impl Copy for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section><section id="impl-Eq-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-Eq-for-Date" class="anchor"></a><h3 class="code-header">impl Eq for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section><section id="impl-StructuralEq-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-StructuralEq-for-Date" class="anchor"></a><h3 class="code-header">impl StructuralEq for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section><section id="impl-StructuralPartialEq-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/time/date.rs.html#35">source</a><a href="#impl-StructuralPartialEq-for-Date" class="anchor"></a><h3 class="code-header">impl StructuralPartialEq for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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-Date" class="impl has-srclink"><a href="#impl-RefUnwindSafe-for-Date" class="anchor"></a><h3 class="code-header">impl RefUnwindSafe for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section><section id="impl-Send-for-Date" class="impl has-srclink"><a href="#impl-Send-for-Date" class="anchor"></a><h3 class="code-header">impl Send for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section><section id="impl-Sync-for-Date" class="impl has-srclink"><a href="#impl-Sync-for-Date" class="anchor"></a><h3 class="code-header">impl Sync for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section><section id="impl-Unpin-for-Date" class="impl has-srclink"><a href="#impl-Unpin-for-Date" class="anchor"></a><h3 class="code-header">impl Unpin for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</a></h3></section><section id="impl-UnwindSafe-for-Date" class="impl has-srclink"><a href="#impl-UnwindSafe-for-Date" class="anchor"></a><h3 class="code-header">impl UnwindSafe for <a class="struct" href="struct.Date.html" title="struct time::Date">Date</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-Date" class="impl has-srclink"><a href="#impl-Any-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; Any for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: 'static + ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl has-srclink"><a href="#method.type_id" class="anchor"></a><h4 class="code-header">fn <a class="fnname">type_id</a>(&amp;self) -&gt; TypeId</h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-Date" class="impl has-srclink"><a href="#impl-Borrow%3CT%3E-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; Borrow&lt;T&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow" 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>(&amp;self) -&gt; &amp;T</h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-Date" class="impl has-srclink"><a href="#impl-BorrowMut%3CT%3E-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; BorrowMut&lt;T&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow_mut" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow_mut</a>(&amp;mut self) -&gt; &amp;mut T</h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-Date" class="impl has-srclink"><a href="#impl-From%3CT%3E-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; From&lt;T&gt; for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from" 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" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(t: T) -&gt; T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-Date" class="impl has-srclink"><a href="#impl-Into%3CU%3E-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; Into&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: From&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">into</a>(self) -&gt; U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p>
<p>That is, this conversion is whatever the implementation of
<code>[From]&lt;T&gt; for U</code> chooses to do.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-ToOwned-for-Date" class="impl has-srclink"><a href="#impl-ToOwned-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; ToOwned for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: Clone,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Owned" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Owned" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Owned</a> = T</h4></section></summary><div class='docblock'>The resulting type after obtaining ownership.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_owned" class="method trait-impl has-srclink"><a href="#method.to_owned" class="anchor"></a><h4 class="code-header">fn <a class="fnname">to_owned</a>(&amp;self) -&gt; T</h4></section></summary><div class='docblock'>Creates owned data from borrowed data, usually by cloning. <a>Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone_into" class="method trait-impl has-srclink"><a href="#method.clone_into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">clone_into</a>(&amp;self, target: &amp;mut T)</h4></section></summary><div class='docblock'>Uses borrowed data to replace owned data, usually by cloning. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-ToString-for-Date" class="impl has-srclink"><a href="#impl-ToString-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; ToString for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;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>(&amp;self) -&gt; 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-Date" class="impl has-srclink"><a href="#impl-TryFrom%3CU%3E-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; TryFrom&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: Into&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-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) -&gt; Result&lt;T, &lt;T as TryFrom&lt;U&gt;&gt;::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-Date" class="impl has-srclink"><a href="#impl-TryInto%3CU%3E-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; TryInto&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: TryFrom&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-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> = &lt;U as TryFrom&lt;T&gt;&gt;::Error</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_into</a>(self) -&gt; Result&lt;U, &lt;U as TryFrom&lt;T&gt;&gt;::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><section id="impl-DeserializeOwned-for-Date" class="impl has-srclink"><a class="srclink rightside" href="../src/serde/de/mod.rs.html#604">source</a><a href="#impl-DeserializeOwned-for-Date" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; <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>&nbsp;&nbsp;&nbsp;&nbsp;T: for&lt;'de&gt; <a class="trait" href="../serde/de/trait.Deserialize.html" title="trait serde::de::Deserialize">Deserialize</a>&lt;'de&gt;,</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>