<!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="ISO 8601 calendar date without timezone. Allows for every proleptic Gregorian date from Jan 1, 262145 BCE to Dec 31, 262143 CE. Also supports the conversion from ISO 8601 ordinal and week date."><title>NaiveDate in chrono::naive - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceSerif4-Regular-46f98efaafac5295.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/FiraSans-Regular-018c141bf0843ffd.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/FiraSans-Medium-8f9a781e4970d388.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceCodePro-Regular-562dcc5011b6de7d.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceSerif4-Bold-a2c9cd1067f8b328.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceCodePro-Semibold-d899c5a5c4aeb14a.ttf.woff2"><link rel="stylesheet" href="../../static.files/normalize-76eba96aa4d2e634.css"><link rel="stylesheet" href="../../static.files/rustdoc-c4dbdcde0fbd8430.css" id="mainThemeStyle"><link rel="stylesheet" id="themeStyle" href="../../static.files/light-db279b6232be9c13.css"><link rel="stylesheet" disabled href="../../static.files/dark-cf923f49f397b216.css"><link rel="stylesheet" disabled href="../../static.files/ayu-be46fdc453a55015.css"><script src="../../static.files/storage-3891ce972e3a2bf8.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../static.files/main-98a684e84ae5b08b.js"></script><noscript><link rel="stylesheet" href="../../static.files/noscript-13285aec31fa243e.css"></noscript><link rel="alternate icon" type="image/png" href="../../static.files/favicon-16x16-8b506e7a72182f1c.png"><link rel="alternate icon" type="image/png" href="../../static.files/favicon-32x32-422f7d1d52889060.png"><link rel="icon" type="image/svg+xml" href="../../static.files/favicon-2c020d218678b618.svg"></head><body class="rustdoc struct"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">☰</button><a class="logo-container" href="../../chrono/index.html"><img class="rust-logo" src="../../static.files/rust-logo-151179464ae7ed46.svg" alt="logo"></a><h2></h2></nav><nav class="sidebar"><a class="logo-container" href="../../chrono/index.html"><img class="rust-logo" src="../../static.files/rust-logo-151179464ae7ed46.svg" alt="logo"></a><h2 class="location"><a href="#">NaiveDate</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.and_hms">and_hms</a></li><li><a href="#method.and_hms_micro">and_hms_micro</a></li><li><a href="#method.and_hms_micro_opt">and_hms_micro_opt</a></li><li><a href="#method.and_hms_milli">and_hms_milli</a></li><li><a href="#method.and_hms_milli_opt">and_hms_milli_opt</a></li><li><a href="#method.and_hms_nano">and_hms_nano</a></li><li><a href="#method.and_hms_nano_opt">and_hms_nano_opt</a></li><li><a href="#method.and_hms_opt">and_hms_opt</a></li><li><a href="#method.and_time">and_time</a></li><li><a href="#method.checked_add_days">checked_add_days</a></li><li><a href="#method.checked_add_months">checked_add_months</a></li><li><a href="#method.checked_add_signed">checked_add_signed</a></li><li><a href="#method.checked_sub_days">checked_sub_days</a></li><li><a href="#method.checked_sub_months">checked_sub_months</a></li><li><a href="#method.checked_sub_signed">checked_sub_signed</a></li><li><a href="#method.format">format</a></li><li><a href="#method.format_with_items">format_with_items</a></li><li><a href="#method.from_isoywd">from_isoywd</a></li><li><a href="#method.from_isoywd_opt">from_isoywd_opt</a></li><li><a href="#method.from_num_days_from_ce">from_num_days_from_ce</a></li><li><a href="#method.from_num_days_from_ce_opt">from_num_days_from_ce_opt</a></li><li><a href="#method.from_weekday_of_month">from_weekday_of_month</a></li><li><a href="#method.from_weekday_of_month_opt">from_weekday_of_month_opt</a></li><li><a href="#method.from_ymd">from_ymd</a></li><li><a href="#method.from_ymd_opt">from_ymd_opt</a></li><li><a href="#method.from_yo">from_yo</a></li><li><a href="#method.from_yo_opt">from_yo_opt</a></li><li><a href="#method.iter_days">iter_days</a></li><li><a href="#method.iter_weeks">iter_weeks</a></li><li><a href="#method.leap_year">leap_year</a></li><li><a href="#method.parse_and_remainder">parse_and_remainder</a></li><li><a href="#method.parse_from_str">parse_from_str</a></li><li><a href="#method.pred">pred</a></li><li><a href="#method.pred_opt">pred_opt</a></li><li><a href="#method.signed_duration_since">signed_duration_since</a></li><li><a href="#method.succ">succ</a></li><li><a href="#method.succ_opt">succ_opt</a></li><li><a href="#method.week">week</a></li><li><a href="#method.years_since">years_since</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block"><li><a href="#impl-Add%3CDays%3E-for-NaiveDate">Add<Days></a></li><li><a href="#impl-Add%3CDuration%3E-for-NaiveDate">Add<Duration></a></li><li><a href="#impl-Add%3CMonths%3E-for-NaiveDate">Add<Months></a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-NaiveDate">AddAssign<Duration></a></li><li><a href="#impl-Clone-for-NaiveDate">Clone</a></li><li><a href="#impl-Copy-for-NaiveDate">Copy</a></li><li><a href="#impl-Datelike-for-NaiveDate">Datelike</a></li><li><a href="#impl-Debug-for-NaiveDate">Debug</a></li><li><a href="#impl-Default-for-NaiveDate">Default</a></li><li><a href="#impl-Display-for-NaiveDate">Display</a></li><li><a href="#impl-Eq-for-NaiveDate">Eq</a></li><li><a href="#impl-From%3CNaiveDateTime%3E-for-NaiveDate">From<NaiveDateTime></a></li><li><a href="#impl-FromStr-for-NaiveDate">FromStr</a></li><li><a href="#impl-Hash-for-NaiveDate">Hash</a></li><li><a href="#impl-Ord-for-NaiveDate">Ord</a></li><li><a href="#impl-PartialEq%3CNaiveDate%3E-for-NaiveDate">PartialEq<NaiveDate></a></li><li><a href="#impl-PartialOrd%3CNaiveDate%3E-for-NaiveDate">PartialOrd<NaiveDate></a></li><li><a href="#impl-StructuralEq-for-NaiveDate">StructuralEq</a></li><li><a href="#impl-StructuralPartialEq-for-NaiveDate">StructuralPartialEq</a></li><li><a href="#impl-Sub%3CDays%3E-for-NaiveDate">Sub<Days></a></li><li><a href="#impl-Sub%3CDuration%3E-for-NaiveDate">Sub<Duration></a></li><li><a href="#impl-Sub%3CMonths%3E-for-NaiveDate">Sub<Months></a></li><li><a href="#impl-Sub%3CNaiveDate%3E-for-NaiveDate">Sub<NaiveDate></a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-NaiveDate">SubAssign<Duration></a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block"><li><a href="#impl-RefUnwindSafe-for-NaiveDate">RefUnwindSafe</a></li><li><a href="#impl-Send-for-NaiveDate">Send</a></li><li><a href="#impl-Sync-for-NaiveDate">Sync</a></li><li><a href="#impl-Unpin-for-NaiveDate">Unpin</a></li><li><a href="#impl-UnwindSafe-for-NaiveDate">UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block"><li><a href="#impl-Any-for-NaiveDate">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-NaiveDate">Borrow<T></a></li><li><a href="#impl-BorrowMut%3CT%3E-for-NaiveDate">BorrowMut<T></a></li><li><a href="#impl-From%3CT%3E-for-NaiveDate">From<T></a></li><li><a href="#impl-Into%3CU%3E-for-NaiveDate">Into<U></a></li><li><a href="#impl-ToOwned-for-NaiveDate">ToOwned</a></li><li><a href="#impl-ToString-for-NaiveDate">ToString</a></li><li><a href="#impl-TryFrom%3CU%3E-for-NaiveDate">TryFrom<U></a></li><li><a href="#impl-TryInto%3CU%3E-for-NaiveDate">TryInto<U></a></li></ul></section><h2><a href="index.html">In chrono::naive</a></h2></div></nav><main><div class="width-limiter"><nav class="sub"><form class="search-form"><span></span><input class="search-input" name="search" aria-label="Run search in the documentation" 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="../../static.files/wheel-7b819b6101059cd0.svg"></a></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1>Struct <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="struct" href="#">NaiveDate</a><button id="copy-path" title="Copy item path to clipboard"><img src="../../static.files/clipboard-7571035ce49a181d.svg" width="19" height="18" alt="Copy item path"></button></h1><span class="out-of-band"><a class="srclink" href="../../src/chrono/naive/date.rs.html#195-197">source</a> · <button id="toggle-all-docs" title="collapse all docs">[<span>−</span>]</button></span></div><pre class="rust item-decl"><code>pub struct NaiveDate { /* private fields */ }</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>ISO 8601 calendar date without timezone.
Allows for every <a href="struct.NaiveDate.html#calendar-date" title="struct chrono::naive::NaiveDate">proleptic Gregorian date</a> from Jan 1, 262145 BCE to Dec 31, 262143 CE.
Also supports the conversion from ISO 8601 ordinal and week date.</p>
<h2 id="calendar-date"><a href="#calendar-date">Calendar Date</a></h2>
<p>The ISO 8601 <strong>calendar date</strong> follows the proleptic Gregorian calendar.
It is like a normal civil calendar but note some slight differences:</p>
<ul>
<li>
<p>Dates before the Gregorian calendar’s inception in 1582 are defined via the extrapolation.
Be careful, as historical dates are often noted in the Julian calendar and others
and the transition to Gregorian may differ across countries (as late as early 20C).</p>
<p>(Some example: Both Shakespeare from Britain and Cervantes from Spain seemingly died
on the same calendar date—April 23, 1616—but in the different calendar.
Britain used the Julian calendar at that time, so Shakespeare’s death is later.)</p>
</li>
<li>
<p>ISO 8601 calendars has the year 0, which is 1 BCE (a year before 1 CE).
If you need a typical BCE/BC and CE/AD notation for year numbers,
use the <a href="../trait.Datelike.html#method.year_ce"><code>Datelike::year_ce</code></a> method.</p>
</li>
</ul>
<h2 id="week-date"><a href="#week-date">Week Date</a></h2>
<p>The ISO 8601 <strong>week date</strong> is a triple of year number, week number
and <a href="../enum.Weekday.html">day of the week</a> with the following rules:</p>
<ul>
<li>
<p>A week consists of Monday through Sunday, and is always numbered within some year.
The week number ranges from 1 to 52 or 53 depending on the year.</p>
</li>
<li>
<p>The week 1 of given year is defined as the first week containing January 4 of that year,
or equivalently, the first week containing four or more days in that year.</p>
</li>
<li>
<p>The year number in the week date may <em>not</em> correspond to the actual Gregorian year.
For example, January 3, 2016 (Sunday) was on the last (53rd) week of 2015.</p>
</li>
</ul>
<p>Chrono’s date types default to the ISO 8601 <a href="#calendar-date">calendar date</a>,
but <a href="../trait.Datelike.html#tymethod.iso_week"><code>Datelike::iso_week</code></a> and
<a href="../trait.Datelike.html#tymethod.weekday"><code>Datelike::weekday</code></a> methods
can be used to get the corresponding week date.</p>
<h2 id="ordinal-date"><a href="#ordinal-date">Ordinal Date</a></h2>
<p>The ISO 8601 <strong>ordinal date</strong> is a pair of year number and day of the year (“ordinal”).
The ordinal number ranges from 1 to 365 or 366 depending on the year.
The year number is the same as that of the <a href="#calendar-date">calendar date</a>.</p>
<p>This is currently the internal format of Chrono’s date types.</p>
</div></details><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor">§</a></h2><div id="implementations-list"><details class="toggle implementors-toggle" open><summary><section id="impl-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#216-1464">source</a><a href="#impl-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.from_ymd" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#259-261">source</a><h4 class="code-header">pub const fn <a href="#method.from_ymd" class="fn">from_ymd</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>, month: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>, day: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>from_ymd_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#calendar-date">calendar date</a>
(year, month and day).</p>
<h5 id="panics"><a href="#panics">Panics</a></h5>
<p>Panics if the specified calendar day does not exist, on invalid values for <code>month</code> or <code>day</code>,
or if <code>year</code> is out of range for <code>NaiveDate</code>.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_ymd_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#288-296">source</a><h4 class="code-header">pub const fn <a href="#method.from_ymd_opt" class="fn">from_ymd_opt</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>, month: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>, day: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#calendar-date">calendar date</a>
(year, month and day).</p>
<h5 id="errors"><a href="#errors">Errors</a></h5>
<p>Returns <code>None</code> if:</p>
<ul>
<li>The specified calendar day does not exist (for example 2023-04-31).</li>
<li>The value for <code>month</code> or <code>day</code> is invalid.</li>
<li><code>year</code> is out of range for <code>NaiveDate</code>.</li>
</ul>
<h5 id="example"><a href="#example">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>from_ymd_opt = NaiveDate::from_ymd_opt;
<span class="macro">assert!</span>(from_ymd_opt(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">14</span>).is_some());
<span class="macro">assert!</span>(from_ymd_opt(<span class="number">2015</span>, <span class="number">0</span>, <span class="number">14</span>).is_none());
<span class="macro">assert!</span>(from_ymd_opt(<span class="number">2015</span>, <span class="number">2</span>, <span class="number">29</span>).is_none());
<span class="macro">assert!</span>(from_ymd_opt(-<span class="number">4</span>, <span class="number">2</span>, <span class="number">29</span>).is_some()); <span class="comment">// 5 BCE is a leap year
</span><span class="macro">assert!</span>(from_ymd_opt(<span class="number">400000</span>, <span class="number">1</span>, <span class="number">1</span>).is_none());
<span class="macro">assert!</span>(from_ymd_opt(-<span class="number">400000</span>, <span class="number">1</span>, <span class="number">1</span>).is_none());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_yo" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#307-309">source</a><h4 class="code-header">pub const fn <a href="#method.from_yo" class="fn">from_yo</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>, ordinal: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>from_yo_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#ordinal-date">ordinal date</a>
(year and day of the year).</p>
<h5 id="panics-1"><a href="#panics-1">Panics</a></h5>
<p>Panics if the specified ordinal day does not exist, on invalid values for <code>ordinal</code>, or if
<code>year</code> is out of range for <code>NaiveDate</code>.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_yo_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#337-340">source</a><h4 class="code-header">pub const fn <a href="#method.from_yo_opt" class="fn">from_yo_opt</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>, ordinal: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#ordinal-date">ordinal date</a>
(year and day of the year).</p>
<h5 id="errors-1"><a href="#errors-1">Errors</a></h5>
<p>Returns <code>None</code> if:</p>
<ul>
<li>The specified ordinal day does not exist (for example 2023-366).</li>
<li>The value for <code>ordinal</code> is invalid (for example: <code>0</code>, <code>400</code>).</li>
<li><code>year</code> is out of range for <code>NaiveDate</code>.</li>
</ul>
<h5 id="example-1"><a href="#example-1">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>from_yo_opt = NaiveDate::from_yo_opt;
<span class="macro">assert!</span>(from_yo_opt(<span class="number">2015</span>, <span class="number">100</span>).is_some());
<span class="macro">assert!</span>(from_yo_opt(<span class="number">2015</span>, <span class="number">0</span>).is_none());
<span class="macro">assert!</span>(from_yo_opt(<span class="number">2015</span>, <span class="number">365</span>).is_some());
<span class="macro">assert!</span>(from_yo_opt(<span class="number">2015</span>, <span class="number">366</span>).is_none());
<span class="macro">assert!</span>(from_yo_opt(-<span class="number">4</span>, <span class="number">366</span>).is_some()); <span class="comment">// 5 BCE is a leap year
</span><span class="macro">assert!</span>(from_yo_opt(<span class="number">400000</span>, <span class="number">1</span>).is_none());
<span class="macro">assert!</span>(from_yo_opt(-<span class="number">400000</span>, <span class="number">1</span>).is_none());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_isoywd" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#352-354">source</a><h4 class="code-header">pub const fn <a href="#method.from_isoywd" class="fn">from_isoywd</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>, week: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>, weekday: <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>from_isoywd_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#week-date">ISO week date</a>
(year, week number and day of the week).
The resulting <code>NaiveDate</code> may have a different year from the input year.</p>
<h5 id="panics-2"><a href="#panics-2">Panics</a></h5>
<p>Panics if the specified week does not exist in that year, on invalid values for <code>week</code>, or
if the resulting date is out of range for <code>NaiveDate</code>.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_isoywd_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#406-436">source</a><h4 class="code-header">pub const fn <a href="#method.from_isoywd_opt" class="fn">from_isoywd_opt</a>(
year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>,
week: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
weekday: <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>
) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#week-date">ISO week date</a>
(year, week number and day of the week).
The resulting <code>NaiveDate</code> may have a different year from the input year.</p>
<h5 id="errors-2"><a href="#errors-2">Errors</a></h5>
<p>Returns <code>None</code> if:</p>
<ul>
<li>The specified week does not exist in that year (for example 2023 week 53).</li>
<li>The value for <code>week</code> is invalid (for example: <code>0</code>, <code>60</code>).</li>
<li>If the resulting date is out of range for <code>NaiveDate</code>.</li>
</ul>
<h5 id="example-2"><a href="#example-2">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Weekday};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="kw">let </span>from_isoywd_opt = NaiveDate::from_isoywd_opt;
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2015</span>, <span class="number">0</span>, Weekday::Sun), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2015</span>, <span class="number">10</span>, Weekday::Sun), <span class="prelude-val">Some</span>(from_ymd(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">8</span>)));
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2015</span>, <span class="number">30</span>, Weekday::Mon), <span class="prelude-val">Some</span>(from_ymd(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">20</span>)));
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2015</span>, <span class="number">60</span>, Weekday::Mon), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">400000</span>, <span class="number">10</span>, Weekday::Fri), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(from_isoywd_opt(-<span class="number">400000</span>, <span class="number">10</span>, Weekday::Sat), <span class="prelude-val">None</span>);</code></pre></div>
<p>The year number of ISO week date may differ from that of the calendar date.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="comment">// Mo Tu We Th Fr Sa Su
// 2014-W52 22 23 24 25 26 27 28 has 4+ days of new year,
// 2015-W01 29 30 31 1 2 3 4 <- so this is the first week
</span><span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2014</span>, <span class="number">52</span>, Weekday::Sun), <span class="prelude-val">Some</span>(from_ymd(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">28</span>)));
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2014</span>, <span class="number">53</span>, Weekday::Mon), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2015</span>, <span class="number">1</span>, Weekday::Mon), <span class="prelude-val">Some</span>(from_ymd(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">29</span>)));
<span class="comment">// 2015-W52 21 22 23 24 25 26 27 has 4+ days of old year,
// 2015-W53 28 29 30 31 1 2 3 <- so this is the last week
// 2016-W01 4 5 6 7 8 9 10
</span><span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2015</span>, <span class="number">52</span>, Weekday::Sun), <span class="prelude-val">Some</span>(from_ymd(<span class="number">2015</span>, <span class="number">12</span>, <span class="number">27</span>)));
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2015</span>, <span class="number">53</span>, Weekday::Sun), <span class="prelude-val">Some</span>(from_ymd(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">3</span>)));
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2015</span>, <span class="number">54</span>, Weekday::Mon), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(from_isoywd_opt(<span class="number">2016</span>, <span class="number">1</span>, Weekday::Mon), <span class="prelude-val">Some</span>(from_ymd(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">4</span>)));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_num_days_from_ce" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#447-449">source</a><h4 class="code-header">pub const fn <a href="#method.from_num_days_from_ce" class="fn">from_num_days_from_ce</a>(days: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>from_num_days_from_ce_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> from a day’s number in the proleptic Gregorian calendar, with
January 1, 1 being day 1.</p>
<h5 id="panics-3"><a href="#panics-3">Panics</a></h5>
<p>Panics if the date is out of range.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_num_days_from_ce_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#474-481">source</a><h4 class="code-header">pub const fn <a href="#method.from_num_days_from_ce_opt" class="fn">from_num_days_from_ce_opt</a>(days: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> from a day’s number in the proleptic Gregorian calendar, with
January 1, 1 being day 1.</p>
<h5 id="errors-3"><a href="#errors-3">Errors</a></h5>
<p>Returns <code>None</code> if the date is out of range.</p>
<h5 id="example-3"><a href="#example-3">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>from_ndays_opt = NaiveDate::from_num_days_from_ce_opt;
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="macro">assert_eq!</span>(from_ndays_opt(<span class="number">730_000</span>), <span class="prelude-val">Some</span>(from_ymd(<span class="number">1999</span>, <span class="number">9</span>, <span class="number">3</span>)));
<span class="macro">assert_eq!</span>(from_ndays_opt(<span class="number">1</span>), <span class="prelude-val">Some</span>(from_ymd(<span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>)));
<span class="macro">assert_eq!</span>(from_ndays_opt(<span class="number">0</span>), <span class="prelude-val">Some</span>(from_ymd(<span class="number">0</span>, <span class="number">12</span>, <span class="number">31</span>)));
<span class="macro">assert_eq!</span>(from_ndays_opt(-<span class="number">1</span>), <span class="prelude-val">Some</span>(from_ymd(<span class="number">0</span>, <span class="number">12</span>, <span class="number">30</span>)));
<span class="macro">assert_eq!</span>(from_ndays_opt(<span class="number">100_000_000</span>), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(from_ndays_opt(-<span class="number">100_000_000</span>), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_weekday_of_month" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#495-502">source</a><h4 class="code-header">pub const fn <a href="#method.from_weekday_of_month" class="fn">from_weekday_of_month</a>(
year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>,
month: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
weekday: <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>,
n: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u8.html">u8</a>
) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>from_weekday_of_month_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> by counting the number of occurrences of a particular day-of-week
since the beginning of the given month. For instance, if you want the 2nd Friday of March
2017, you would use <code>NaiveDate::from_weekday_of_month(2017, 3, Weekday::Fri, 2)</code>.</p>
<p><code>n</code> is 1-indexed.</p>
<h5 id="panics-4"><a href="#panics-4">Panics</a></h5>
<p>Panics if the specified day does not exist in that month, on invalid values for <code>month</code> or
<code>n</code>, or if <code>year</code> is out of range for <code>NaiveDate</code>.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_weekday_of_month_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#525-538">source</a><h4 class="code-header">pub const fn <a href="#method.from_weekday_of_month_opt" class="fn">from_weekday_of_month_opt</a>(
year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>,
month: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
weekday: <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>,
n: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u8.html">u8</a>
) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> by counting the number of occurrences of a particular day-of-week
since the beginning of the given month. For instance, if you want the 2nd Friday of March
2017, you would use <code>NaiveDate::from_weekday_of_month(2017, 3, Weekday::Fri, 2)</code>.</p>
<p><code>n</code> is 1-indexed.</p>
<h5 id="errors-4"><a href="#errors-4">Errors</a></h5>
<p>Returns <code>None</code> if:</p>
<ul>
<li>The specified day does not exist in that month (for example the 5th Monday of Apr. 2023).</li>
<li>The value for <code>month</code> or <code>n</code> is invalid.</li>
<li><code>year</code> is out of range for <code>NaiveDate</code>.</li>
</ul>
<h5 id="example-4"><a href="#example-4">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Weekday};
<span class="macro">assert_eq!</span>(NaiveDate::from_weekday_of_month_opt(<span class="number">2017</span>, <span class="number">3</span>, Weekday::Fri, <span class="number">2</span>),
NaiveDate::from_ymd_opt(<span class="number">2017</span>, <span class="number">3</span>, <span class="number">10</span>))</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.parse_from_str" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#582-586">source</a><h4 class="code-header">pub fn <a href="#method.parse_from_str" class="fn">parse_from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>, fmt: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>) -> <a class="type" href="../format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Parses a string with the specified format string and returns a new <code>NaiveDate</code>.
See the <a href="../format/strftime/index.html"><code>format::strftime</code> module</a>
on the supported escape sequences.</p>
<h5 id="example-5"><a href="#example-5">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>parse_from_str = NaiveDate::parse_from_str;
<span class="macro">assert_eq!</span>(parse_from_str(<span class="string">"2015-09-05"</span>, <span class="string">"%Y-%m-%d"</span>),
<span class="prelude-val">Ok</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap()));
<span class="macro">assert_eq!</span>(parse_from_str(<span class="string">"5sep2015"</span>, <span class="string">"%d%b%Y"</span>),
<span class="prelude-val">Ok</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap()));</code></pre></div>
<p>Time and offset is ignored for the purpose of parsing.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(parse_from_str(<span class="string">"2014-5-17T12:34:56+09:30"</span>, <span class="string">"%Y-%m-%dT%H:%M:%S%z"</span>),
<span class="prelude-val">Ok</span>(NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">5</span>, <span class="number">17</span>).unwrap()));</code></pre></div>
<p>Out-of-bound dates or insufficient fields are errors.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(parse_from_str(<span class="string">"2015/9"</span>, <span class="string">"%Y/%m"</span>).is_err());
<span class="macro">assert!</span>(parse_from_str(<span class="string">"2015/9/31"</span>, <span class="string">"%Y/%m/%d"</span>).is_err());</code></pre></div>
<p>All parsed fields should be consistent to each other, otherwise it’s an error.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(parse_from_str(<span class="string">"Sat, 09 Aug 2013"</span>, <span class="string">"%a, %d %b %Y"</span>).is_err());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.parse_and_remainder" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#604-608">source</a><h4 class="code-header">pub fn <a href="#method.parse_and_remainder" class="fn">parse_and_remainder</a><'a>(
s: &'a <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>,
fmt: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>
) -> <a class="type" href="../format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><(<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>, &'a <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>)></h4></section></summary><div class="docblock"><p>Parses a string from a user-specified format into a new <code>NaiveDate</code> value, and a slice with
the remaining portion of the string.
See the <a href="../format/strftime/index.html"><code>format::strftime</code> module</a>
on the supported escape sequences.</p>
<p>Similar to <a href="#method.parse_from_str"><code>parse_from_str</code></a>.</p>
<h5 id="example-6"><a href="#example-6">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>(date, remainder) = NaiveDate::parse_and_remainder(
<span class="string">"2015-02-18 trailing text"</span>, <span class="string">"%Y-%m-%d"</span>).unwrap();
<span class="macro">assert_eq!</span>(date, NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">2</span>, <span class="number">18</span>).unwrap());
<span class="macro">assert_eq!</span>(remainder, <span class="string">" trailing text"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_add_months" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#632-641">source</a><h4 class="code-header">pub const fn <a href="#method.checked_add_months" class="fn">checked_add_months</a>(self, months: <a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><Self></h4></section></summary><div class="docblock"><p>Add a duration in <a href="../struct.Months.html" title="struct chrono::Months"><code>Months</code></a> to the date</p>
<p>Uses the last day of the month if the day does not exist in the resulting month.</p>
<h5 id="errors-5"><a href="#errors-5">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-7"><a href="#example-7">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">2</span>, <span class="number">20</span>).unwrap().checked_add_months(Months::new(<span class="number">6</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">8</span>, <span class="number">20</span>).unwrap())
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">7</span>, <span class="number">31</span>).unwrap().checked_add_months(Months::new(<span class="number">2</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap())
);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_sub_months" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#667-677">source</a><h4 class="code-header">pub const fn <a href="#method.checked_sub_months" class="fn">checked_sub_months</a>(self, months: <a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><Self></h4></section></summary><div class="docblock"><p>Subtract a duration in <a href="../struct.Months.html" title="struct chrono::Months"><code>Months</code></a> from the date</p>
<p>Uses the last day of the month if the day does not exist in the resulting month.</p>
<h5 id="errors-6"><a href="#errors-6">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-8"><a href="#example-8">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">2</span>, <span class="number">20</span>).unwrap().checked_sub_months(Months::new(<span class="number">6</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2021</span>, <span class="number">8</span>, <span class="number">20</span>).unwrap())
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap()
.checked_sub_months(Months::new(core::i32::MAX <span class="kw">as </span>u32 + <span class="number">1</span>)),
<span class="prelude-val">None
</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_add_days" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#749-754">source</a><h4 class="code-header">pub const fn <a href="#method.checked_add_days" class="fn">checked_add_days</a>(self, days: <a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><Self></h4></section></summary><div class="docblock"><p>Add a duration in <a href="struct.Days.html" title="struct chrono::naive::Days"><code>Days</code></a> to the date</p>
<h5 id="errors-7"><a href="#errors-7">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-9"><a href="#example-9">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">2</span>, <span class="number">20</span>).unwrap().checked_add_days(Days::new(<span class="number">9</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">3</span>, <span class="number">1</span>).unwrap())
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">7</span>, <span class="number">31</span>).unwrap().checked_add_days(Days::new(<span class="number">2</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">8</span>, <span class="number">2</span>).unwrap())
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">7</span>, <span class="number">31</span>).unwrap().checked_add_days(Days::new(<span class="number">1000000000000</span>)),
<span class="prelude-val">None
</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_sub_days" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#776-781">source</a><h4 class="code-header">pub const fn <a href="#method.checked_sub_days" class="fn">checked_sub_days</a>(self, days: <a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><Self></h4></section></summary><div class="docblock"><p>Subtract a duration in <a href="struct.Days.html" title="struct chrono::naive::Days"><code>Days</code></a> from the date</p>
<h5 id="errors-8"><a href="#errors-8">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-10"><a href="#example-10">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">2</span>, <span class="number">20</span>).unwrap().checked_sub_days(Days::new(<span class="number">6</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">2</span>, <span class="number">14</span>).unwrap())
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2022</span>, <span class="number">2</span>, <span class="number">20</span>).unwrap().checked_sub_days(Days::new(<span class="number">1000000000000</span>)),
<span class="prelude-val">None
</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_time" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#822-824">source</a><h4 class="code-header">pub const fn <a href="#method.and_time" class="fn">and_time</a>(&self, time: <a class="struct" href="struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date and given <code>NaiveTime</code>.</p>
<h5 id="example-11"><a href="#example-11">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveTime, NaiveDateTime};
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap();
<span class="kw">let </span>t = NaiveTime::from_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="kw">let </span>dt: NaiveDateTime = d.and_time(t);
<span class="macro">assert_eq!</span>(dt.date(), d);
<span class="macro">assert_eq!</span>(dt.time(), t);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_hms" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#837-839">source</a><h4 class="code-header">pub const fn <a href="#method.and_hms" class="fn">and_hms</a>(&self, hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>, min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>, sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>and_hms_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute and second.</p>
<p>No <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a> is allowed here;
use <code>NaiveDate::and_hms_*</code> methods with a subsecond parameter instead.</p>
<h5 id="panics-5"><a href="#panics-5">Panics</a></h5>
<p>Panics on invalid hour, minute and/or second.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_hms_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#863-866">source</a><h4 class="code-header">pub const fn <a href="#method.and_hms_opt" class="fn">and_hms_opt</a>(
&self,
hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>
) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute and second.</p>
<p>No <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a> is allowed here;
use <code>NaiveDate::and_hms_*_opt</code> methods with a subsecond parameter instead.</p>
<h5 id="errors-9"><a href="#errors-9">Errors</a></h5>
<p>Returns <code>None</code> on invalid hour, minute and/or second.</p>
<h5 id="example-12"><a href="#example-12">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap();
<span class="macro">assert!</span>(d.and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).is_some());
<span class="macro">assert!</span>(d.and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>).is_none()); <span class="comment">// use `and_hms_milli_opt` instead
</span><span class="macro">assert!</span>(d.and_hms_opt(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_opt(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>).is_none());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_hms_milli" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#879-881">source</a><h4 class="code-header">pub const fn <a href="#method.and_hms_milli" class="fn">and_hms_milli</a>(
&self,
hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
milli: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>
) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>and_hms_milli_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and millisecond.</p>
<p>The millisecond part is allowed to exceed 1,000,000,000 in order to represent a <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>, but only when <code>sec == 59</code>.</p>
<h5 id="panics-6"><a href="#panics-6">Panics</a></h5>
<p>Panics on invalid hour, minute, second and/or millisecond.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_hms_milli_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#907-916">source</a><h4 class="code-header">pub const fn <a href="#method.and_hms_milli_opt" class="fn">and_hms_milli_opt</a>(
&self,
hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
milli: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>
) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and millisecond.</p>
<p>The millisecond part is allowed to exceed 1,000,000,000 in order to represent a <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>, but only when <code>sec == 59</code>.</p>
<h5 id="errors-10"><a href="#errors-10">Errors</a></h5>
<p>Returns <code>None</code> on invalid hour, minute, second and/or millisecond.</p>
<h5 id="example-13"><a href="#example-13">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap();
<span class="macro">assert!</span>(d.and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).is_some());
<span class="macro">assert!</span>(d.and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789</span>).is_some()); <span class="comment">// leap second
</span><span class="macro">assert!</span>(d.and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_milli_opt(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_milli_opt(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).is_none());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_hms_micro" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#943-945">source</a><h4 class="code-header">pub const fn <a href="#method.and_hms_micro" class="fn">and_hms_micro</a>(
&self,
hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
micro: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>
) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>and_hms_micro_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and microsecond.</p>
<p>The microsecond part is allowed to exceed 1,000,000,000 in order to represent a <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>, but only when <code>sec == 59</code>.</p>
<h5 id="panics-7"><a href="#panics-7">Panics</a></h5>
<p>Panics on invalid hour, minute, second and/or microsecond.</p>
<h5 id="example-14"><a href="#example-14">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike, Timelike, Weekday};
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap();
<span class="kw">let </span>dt: NaiveDateTime = d.and_hms_micro_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.year(), <span class="number">2015</span>);
<span class="macro">assert_eq!</span>(dt.weekday(), Weekday::Wed);
<span class="macro">assert_eq!</span>(dt.second(), <span class="number">56</span>);
<span class="macro">assert_eq!</span>(dt.nanosecond(), <span class="number">789_012_000</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_hms_micro_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#971-980">source</a><h4 class="code-header">pub const fn <a href="#method.and_hms_micro_opt" class="fn">and_hms_micro_opt</a>(
&self,
hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
micro: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>
) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and microsecond.</p>
<p>The microsecond part is allowed to exceed 1,000,000,000 in order to represent a <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>, but only when <code>sec == 59</code>.</p>
<h5 id="errors-11"><a href="#errors-11">Errors</a></h5>
<p>Returns <code>None</code> on invalid hour, minute, second and/or microsecond.</p>
<h5 id="example-15"><a href="#example-15">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap();
<span class="macro">assert!</span>(d.and_hms_micro_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>).is_some());
<span class="macro">assert!</span>(d.and_hms_micro_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789_012</span>).is_some()); <span class="comment">// leap second
</span><span class="macro">assert!</span>(d.and_hms_micro_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789_012</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_micro_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789_012</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_micro_opt(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789_012</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_micro_opt(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>).is_none());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_hms_nano" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#993-995">source</a><h4 class="code-header">pub const fn <a href="#method.and_hms_nano" class="fn">and_hms_nano</a>(
&self,
hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
nano: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>
) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>and_hms_nano_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and nanosecond.</p>
<p>The nanosecond part is allowed to exceed 1,000,000,000 in order to represent a <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>, but only when <code>sec == 59</code>.</p>
<h5 id="panics-8"><a href="#panics-8">Panics</a></h5>
<p>Panics on invalid hour, minute, second and/or nanosecond.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_hms_nano_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1021-1030">source</a><h4 class="code-header">pub const fn <a href="#method.and_hms_nano_opt" class="fn">and_hms_nano_opt</a>(
&self,
hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>,
nano: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>
) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and nanosecond.</p>
<p>The nanosecond part is allowed to exceed 1,000,000,000 in order to represent a <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>, but only when <code>sec == 59</code>.</p>
<h5 id="errors-12"><a href="#errors-12">Errors</a></h5>
<p>Returns <code>None</code> on invalid hour, minute, second and/or nanosecond.</p>
<h5 id="example-16"><a href="#example-16">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap();
<span class="macro">assert!</span>(d.and_hms_nano_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).is_some());
<span class="macro">assert!</span>(d.and_hms_nano_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789_012_345</span>).is_some()); <span class="comment">// leap second
</span><span class="macro">assert!</span>(d.and_hms_nano_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789_012_345</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_nano_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789_012_345</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_nano_opt(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).is_none());
<span class="macro">assert!</span>(d.and_hms_nano_opt(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).is_none());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.succ" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1069-1071">source</a><h4 class="code-header">pub const fn <a href="#method.succ" class="fn">succ</a>(&self) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>succ_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the next calendar date.</p>
<h5 id="panics-9"><a href="#panics-9">Panics</a></h5>
<p>Panics when <code>self</code> is the last representable date.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.succ_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1090-1095">source</a><h4 class="code-header">pub const fn <a href="#method.succ_opt" class="fn">succ_opt</a>(&self) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the next calendar date.</p>
<h5 id="errors-13"><a href="#errors-13">Errors</a></h5>
<p>Returns <code>None</code> when <code>self</code> is the last representable date.</p>
<h5 id="example-17"><a href="#example-17">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap().succ_opt(),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">4</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::MAX.succ_opt(), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.pred" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1105-1107">source</a><h4 class="code-header">pub const fn <a href="#method.pred" class="fn">pred</a>(&self) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>pred_opt()</code> instead</span></div></span></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the previous calendar date.</p>
<h5 id="panics-10"><a href="#panics-10">Panics</a></h5>
<p>Panics when <code>self</code> is the first representable date.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.pred_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1126-1131">source</a><h4 class="code-header">pub const fn <a href="#method.pred_opt" class="fn">pred_opt</a>(&self) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the previous calendar date.</p>
<h5 id="errors-14"><a href="#errors-14">Errors</a></h5>
<p>Returns <code>None</code> when <code>self</code> is the first representable date.</p>
<h5 id="example-18"><a href="#example-18">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap().pred_opt(),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">2</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::MIN.pred_opt(), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_add_signed" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1154-1157">source</a><h4 class="code-header">pub fn <a href="#method.checked_add_signed" class="fn">checked_add_signed</a>(self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Adds the number of whole days in the given <code>Duration</code> to the current date.</p>
<h5 id="errors-15"><a href="#errors-15">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-19"><a href="#example-19">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap();
<span class="macro">assert_eq!</span>(d.checked_add_signed(Duration::days(<span class="number">40</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">15</span>).unwrap()));
<span class="macro">assert_eq!</span>(d.checked_add_signed(Duration::days(-<span class="number">40</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">27</span>).unwrap()));
<span class="macro">assert_eq!</span>(d.checked_add_signed(Duration::days(<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(d.checked_add_signed(Duration::days(-<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(NaiveDate::MAX.checked_add_signed(Duration::days(<span class="number">1</span>)), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_sub_signed" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1180-1183">source</a><h4 class="code-header">pub fn <a href="#method.checked_sub_signed" class="fn">checked_sub_signed</a>(self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Subtracts the number of whole days in the given <code>Duration</code> from the current date.</p>
<h5 id="errors-16"><a href="#errors-16">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-20"><a href="#example-20">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap();
<span class="macro">assert_eq!</span>(d.checked_sub_signed(Duration::days(<span class="number">40</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">27</span>).unwrap()));
<span class="macro">assert_eq!</span>(d.checked_sub_signed(Duration::days(-<span class="number">40</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">15</span>).unwrap()));
<span class="macro">assert_eq!</span>(d.checked_sub_signed(Duration::days(<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(d.checked_sub_signed(Duration::days(-<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
<span class="macro">assert_eq!</span>(NaiveDate::MIN.checked_sub_signed(Duration::days(<span class="number">1</span>)), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.signed_duration_since" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1208-1218">source</a><h4 class="code-header">pub fn <a href="#method.signed_duration_since" class="fn">signed_duration_since</a>(self, rhs: <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a></h4></section></summary><div class="docblock"><p>Subtracts another <code>NaiveDate</code> from the current date.
Returns a <code>Duration</code> of integral numbers.</p>
<p>This does not overflow or underflow at all,
as all possible output fits in the range of <code>Duration</code>.</p>
<h5 id="example-21"><a href="#example-21">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="kw">let </span>since = NaiveDate::signed_duration_since;
<span class="macro">assert_eq!</span>(since(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>)), Duration::zero());
<span class="macro">assert_eq!</span>(since(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), from_ymd(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>)), Duration::days(<span class="number">1</span>));
<span class="macro">assert_eq!</span>(since(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>)), Duration::days(-<span class="number">1</span>));
<span class="macro">assert_eq!</span>(since(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), from_ymd(<span class="number">2013</span>, <span class="number">9</span>, <span class="number">23</span>)), Duration::days(<span class="number">100</span>));
<span class="macro">assert_eq!</span>(since(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), from_ymd(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">1</span>)), Duration::days(<span class="number">365</span>));
<span class="macro">assert_eq!</span>(since(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), from_ymd(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>)), Duration::days(<span class="number">365</span><span class="kw-2">*</span><span class="number">4 </span>+ <span class="number">1</span>));
<span class="macro">assert_eq!</span>(since(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), from_ymd(<span class="number">1614</span>, <span class="number">1</span>, <span class="number">1</span>)), Duration::days(<span class="number">365</span><span class="kw-2">*</span><span class="number">400 </span>+ <span class="number">97</span>));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.years_since" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1226-1238">source</a><h4 class="code-header">pub const fn <a href="#method.years_since" class="fn">years_since</a>(&self, base: Self) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>></h4></section></summary><div class="docblock"><p>Returns the number of whole years from the given <code>base</code> until <code>self</code>.</p>
<h5 id="errors-17"><a href="#errors-17">Errors</a></h5>
<p>Returns <code>None</code> if <code>base < self</code>.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.format_with_items" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1271-1277">source</a><h4 class="code-header">pub fn <a href="#method.format_with_items" class="fn">format_with_items</a><'a, I, B>(&self, items: I) -> <a class="struct" href="../format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><I><span class="where fmt-newline">where
I: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/iter/traits/iterator/trait.Iterator.html" title="trait core::iter::traits::iterator::Iterator">Iterator</a><Item = B> + <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,
B: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><<a class="enum" href="../format/enum.Item.html" title="enum chrono::format::Item">Item</a><'a>>,</span></h4></section></summary><div class="docblock"><p>Formats the date with the specified formatting items.
Otherwise it is the same as the ordinary <code>format</code> method.</p>
<p>The <code>Iterator</code> of items should be <code>Clone</code>able,
since the resulting <code>DelayedFormat</code> value may be formatted multiple times.</p>
<h5 id="example-22"><a href="#example-22">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">use </span>chrono::format::strftime::StrftimeItems;
<span class="kw">let </span>fmt = StrftimeItems::new(<span class="string">"%Y-%m-%d"</span>);
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap();
<span class="macro">assert_eq!</span>(d.format_with_items(fmt.clone()).to_string(), <span class="string">"2015-09-05"</span>);
<span class="macro">assert_eq!</span>(d.format(<span class="string">"%Y-%m-%d"</span>).to_string(), <span class="string">"2015-09-05"</span>);</code></pre></div>
<p>The resulting <code>DelayedFormat</code> can be formatted directly via the <code>Display</code> trait.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, d.format_with_items(fmt)), <span class="string">"2015-09-05"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.format" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1315-1317">source</a><h4 class="code-header">pub fn <a href="#method.format" class="fn">format</a><'a>(&self, fmt: &'a <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>) -> <a class="struct" href="../format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><<a class="struct" href="../format/strftime/struct.StrftimeItems.html" title="struct chrono::format::strftime::StrftimeItems">StrftimeItems</a><'a>></h4></section></summary><div class="docblock"><p>Formats the date with the specified format string.
See the <a href="../format/strftime/index.html"><code>format::strftime</code> module</a>
on the supported escape sequences.</p>
<p>This returns a <code>DelayedFormat</code>,
which gets converted to a string only when actual formatting happens.
You may use the <code>to_string</code> method to get a <code>String</code>,
or just feed it into <code>print!</code> and other formatting macros.
(In this way it avoids the redundant memory allocation.)</p>
<p>A wrong format string does <em>not</em> issue an error immediately.
Rather, converting or formatting the <code>DelayedFormat</code> fails.
You are recommended to immediately use <code>DelayedFormat</code> for this reason.</p>
<h5 id="example-23"><a href="#example-23">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap();
<span class="macro">assert_eq!</span>(d.format(<span class="string">"%Y-%m-%d"</span>).to_string(), <span class="string">"2015-09-05"</span>);
<span class="macro">assert_eq!</span>(d.format(<span class="string">"%A, %-d %B, %C%y"</span>).to_string(), <span class="string">"Saturday, 5 September, 2015"</span>);</code></pre></div>
<p>The resulting <code>DelayedFormat</code> can be formatted directly via the <code>Display</code> trait.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, d.format(<span class="string">"%Y-%m-%d"</span>)), <span class="string">"2015-09-05"</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, d.format(<span class="string">"%A, %-d %B, %C%y"</span>)), <span class="string">"Saturday, 5 September, 2015"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.iter_days" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1379-1381">source</a><h4 class="code-header">pub const fn <a href="#method.iter_days" class="fn">iter_days</a>(&self) -> <a class="struct" href="struct.NaiveDateDaysIterator.html" title="struct chrono::naive::NaiveDateDaysIterator">NaiveDateDaysIterator</a> <a href="#" class="tooltip" data-notable-ty="NaiveDateDaysIterator">ⓘ</a></h4></section></summary><div class="docblock"><p>Returns an iterator that steps by days across all representable dates.</p>
<h5 id="example-24"><a href="#example-24">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code>
<span class="kw">let </span>expected = [
NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>).unwrap(),
NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">28</span>).unwrap(),
NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).unwrap(),
NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">1</span>).unwrap(),
];
<span class="kw">let </span><span class="kw-2">mut </span>count = <span class="number">0</span>;
<span class="kw">for </span>(idx, d) <span class="kw">in </span>NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>).unwrap().iter_days().take(<span class="number">4</span>).enumerate() {
<span class="macro">assert_eq!</span>(d, expected[idx]);
count += <span class="number">1</span>;
}
<span class="macro">assert_eq!</span>(count, <span class="number">4</span>);
<span class="kw">for </span>d <span class="kw">in </span>NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">1</span>).unwrap().iter_days().rev().take(<span class="number">4</span>) {
count -= <span class="number">1</span>;
<span class="macro">assert_eq!</span>(d, expected[count]);
}</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.iter_weeks" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1410-1412">source</a><h4 class="code-header">pub const fn <a href="#method.iter_weeks" class="fn">iter_weeks</a>(&self) -> <a class="struct" href="struct.NaiveDateWeeksIterator.html" title="struct chrono::naive::NaiveDateWeeksIterator">NaiveDateWeeksIterator</a> <a href="#" class="tooltip" data-notable-ty="NaiveDateWeeksIterator">ⓘ</a></h4></section></summary><div class="docblock"><p>Returns an iterator that steps by weeks across all representable dates.</p>
<h5 id="example-25"><a href="#example-25">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code>
<span class="kw">let </span>expected = [
NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>).unwrap(),
NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">5</span>).unwrap(),
NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">12</span>).unwrap(),
NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">19</span>).unwrap(),
];
<span class="kw">let </span><span class="kw-2">mut </span>count = <span class="number">0</span>;
<span class="kw">for </span>(idx, d) <span class="kw">in </span>NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>).unwrap().iter_weeks().take(<span class="number">4</span>).enumerate() {
<span class="macro">assert_eq!</span>(d, expected[idx]);
count += <span class="number">1</span>;
}
<span class="macro">assert_eq!</span>(count, <span class="number">4</span>);
<span class="kw">for </span>d <span class="kw">in </span>NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">19</span>).unwrap().iter_weeks().rev().take(<span class="number">4</span>) {
count -= <span class="number">1</span>;
<span class="macro">assert_eq!</span>(d, expected[count]);
}</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.week" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1417-1419">source</a><h4 class="code-header">pub const fn <a href="#method.week" class="fn">week</a>(&self, start: <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>) -> <a class="struct" href="struct.NaiveWeek.html" title="struct chrono::naive::NaiveWeek">NaiveWeek</a></h4></section></summary><div class="docblock"><p>Returns the <a href="struct.NaiveWeek.html" title="struct chrono::naive::NaiveWeek"><code>NaiveWeek</code></a> that the date belongs to, starting with the <a href="../enum.Weekday.html" title="enum chrono::Weekday"><code>Weekday</code></a>
specified.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.leap_year" class="method"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1432-1434">source</a><h4 class="code-header">pub const fn <a href="#method.leap_year" class="fn">leap_year</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class="docblock"><p>Returns <code>true</code> if this is a leap year.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2000</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().leap_year(), <span class="bool-val">true</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2001</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().leap_year(), <span class="bool-val">false</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2002</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().leap_year(), <span class="bool-val">false</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2003</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().leap_year(), <span class="bool-val">false</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2004</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().leap_year(), <span class="bool-val">true</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2100</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().leap_year(), <span class="bool-val">false</span>);</code></pre></div>
</div></details><details class="toggle" open><summary><section id="associatedconstant.MIN" class="associatedconstant"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1461">source</a><h4 class="code-header">pub const <a href="#associatedconstant.MIN" class="constant">MIN</a>: <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a> = _</h4></section></summary><div class="docblock"><p>The minimum possible <code>NaiveDate</code> (January 1, 262145 BCE).</p>
</div></details><details class="toggle" open><summary><section id="associatedconstant.MAX" class="associatedconstant"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1463">source</a><h4 class="code-header">pub const <a href="#associatedconstant.MAX" class="constant">MAX</a>: <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a> = _</h4></section></summary><div class="docblock"><p>The maximum possible <code>NaiveDate</code> (December 31, 262143 CE).</p>
</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="toggle implementors-toggle" open><summary><section id="impl-Add%3CDays%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1921-1927">source</a><a href="#impl-Add%3CDays%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-1" class="associatedtype trait-impl"><a href="#associatedtype.Output-1" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.add" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1924-1926">source</a><a href="#method.add" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add" class="fn">add</a>(self, days: <a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>) -> Self::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" title="type core::ops::arith::Add::Output">Output</a></h4></section></summary><div class='docblock'>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Add%3CDuration%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1852-1859">source</a><a href="#impl-Add%3CDuration%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="docblock"><p>An addition of <code>Duration</code> to <code>NaiveDate</code> discards the fractional days,
rounding to the closest integral number of days towards <code>Duration::zero()</code>.</p>
<p>Panics on underflow or overflow. Use <a href="struct.NaiveDate.html#method.checked_add_signed" title="method chrono::naive::NaiveDate::checked_add_signed"><code>NaiveDate::checked_add_signed</code></a> to detect that.</p>
<h4 id="example-48"><a href="#example-48">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Duration::zero(), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Duration::seconds(<span class="number">86399</span>), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Duration::seconds(-<span class="number">86399</span>), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Duration::days(<span class="number">1</span>), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Duration::days(-<span class="number">1</span>), from_ymd(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Duration::days(<span class="number">364</span>), from_ymd(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">31</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Duration::days(<span class="number">365</span><span class="kw-2">*</span><span class="number">4 </span>+ <span class="number">1</span>), from_ymd(<span class="number">2018</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Duration::days(<span class="number">365</span><span class="kw-2">*</span><span class="number">400 </span>+ <span class="number">97</span>), from_ymd(<span class="number">2414</span>, <span class="number">1</span>, <span class="number">1</span>));</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-6" class="associatedtype trait-impl"><a href="#associatedtype.Output-6" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.add-2" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1856-1858">source</a><a href="#method.add-2" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add" class="fn">add</a>(self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Add%3CMonths%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1868-1894">source</a><a href="#impl-Add%3CMonths%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.add-1" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1891-1893">source</a><a href="#method.add-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add" class="fn">add</a>(self, months: <a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>) -> Self::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" title="type core::ops::arith::Add::Output">Output</a></h4></section></summary><div class="docblock"><p>An addition of months to <code>NaiveDate</code> clamped to valid days in resulting month.</p>
<h5 id="panics-11"><a href="#panics-11">Panics</a></h5>
<p>Panics if the resulting date would be out of range.</p>
<h5 id="example-29"><a href="#example-29">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Months};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Months::new(<span class="number">1</span>), from_ymd(<span class="number">2014</span>, <span class="number">2</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Months::new(<span class="number">11</span>), from_ymd(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Months::new(<span class="number">12</span>), from_ymd(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) + Months::new(<span class="number">13</span>), from_ymd(<span class="number">2015</span>, <span class="number">2</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">31</span>) + Months::new(<span class="number">1</span>), from_ymd(<span class="number">2014</span>, <span class="number">2</span>, <span class="number">28</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2020</span>, <span class="number">1</span>, <span class="number">31</span>) + Months::new(<span class="number">1</span>), from_ymd(<span class="number">2020</span>, <span class="number">2</span>, <span class="number">29</span>));</code></pre></div>
</div></details><details class="toggle" open><summary><section id="associatedtype.Output-3" class="associatedtype trait-impl"><a href="#associatedtype.Output-3" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-AddAssign%3CDuration%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1861-1866">source</a><a href="#impl-AddAssign%3CDuration%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html" title="trait core::ops::arith::AddAssign">AddAssign</a><<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.add_assign" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1863-1865">source</a><a href="#method.add_assign" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html#tymethod.add_assign" class="fn">add_assign</a>(&mut self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</h4></section></summary><div class='docblock'>Performs the <code>+=</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html#tymethod.add_assign">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Clone-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-Clone-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.clone" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#method.clone" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html#tymethod.clone" class="fn">clone</a>(&self) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>Returns a copy of the value. <a href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html#tymethod.clone">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clone_from" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/clone.rs.html#132-134">source</a></span><a href="#method.clone_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html#method.clone_from" class="fn">clone_from</a>(&mut self, source: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Self</a>)</h4></section></summary><div class='docblock'>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html#method.clone_from">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Datelike-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1466-1827">source</a><a href="#impl-Datelike-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="../trait.Datelike.html" title="trait chrono::Datelike">Datelike</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.year" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1478-1480">source</a><a href="#method.year" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.year" class="fn">year</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a></h4></section></summary><div class="docblock"><p>Returns the year number in the <a href="#calendar-date">calendar date</a>.</p>
<h5 id="example-32"><a href="#example-32">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().year(), <span class="number">2015</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).unwrap().year(), -<span class="number">308</span>); <span class="comment">// 309 BCE</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.month" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1495-1497">source</a><a href="#method.month" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.month" class="fn">month</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the month number starting from 1.</p>
<p>The return value ranges from 1 to 12.</p>
<h5 id="example-33"><a href="#example-33">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().month(), <span class="number">9</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).unwrap().month(), <span class="number">3</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.month0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1512-1514">source</a><a href="#method.month0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.month0" class="fn">month0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the month number starting from 0.</p>
<p>The return value ranges from 0 to 11.</p>
<h5 id="example-34"><a href="#example-34">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().month0(), <span class="number">8</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).unwrap().month0(), <span class="number">2</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.day" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1552-1554">source</a><a href="#method.day" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.day" class="fn">day</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the day of month starting from 1.</p>
<p>The return value ranges from 1 to 31. (The last day of month differs by months.)</p>
<h5 id="example-35"><a href="#example-35">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().day(), <span class="number">8</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).unwrap().day(), <span class="number">14</span>);</code></pre></div>
<p>Combined with <a href="#method.pred"><code>NaiveDate::pred</code></a>,
one can determine the number of days in a particular month.
(Note that this panics when <code>year</code> is out of range.)</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="kw">fn </span>ndays_in_month(year: i32, month: u32) -> u32 {
<span class="comment">// the first day of the next month...
</span><span class="kw">let </span>(y, m) = <span class="kw">if </span>month == <span class="number">12 </span>{ (year + <span class="number">1</span>, <span class="number">1</span>) } <span class="kw">else </span>{ (year, month + <span class="number">1</span>) };
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(y, m, <span class="number">1</span>).unwrap();
<span class="comment">// ...is preceded by the last day of the original month
</span>d.pred_opt().unwrap().day()
}
<span class="macro">assert_eq!</span>(ndays_in_month(<span class="number">2015</span>, <span class="number">8</span>), <span class="number">31</span>);
<span class="macro">assert_eq!</span>(ndays_in_month(<span class="number">2015</span>, <span class="number">9</span>), <span class="number">30</span>);
<span class="macro">assert_eq!</span>(ndays_in_month(<span class="number">2015</span>, <span class="number">12</span>), <span class="number">31</span>);
<span class="macro">assert_eq!</span>(ndays_in_month(<span class="number">2016</span>, <span class="number">2</span>), <span class="number">29</span>);
<span class="macro">assert_eq!</span>(ndays_in_month(<span class="number">2017</span>, <span class="number">2</span>), <span class="number">28</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.day0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1569-1571">source</a><a href="#method.day0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.day0" class="fn">day0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the day of month starting from 0.</p>
<p>The return value ranges from 0 to 30. (The last day of month differs by months.)</p>
<h5 id="example-36"><a href="#example-36">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().day0(), <span class="number">7</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).unwrap().day0(), <span class="number">13</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.ordinal" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1608-1610">source</a><a href="#method.ordinal" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.ordinal" class="fn">ordinal</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the day of year starting from 1.</p>
<p>The return value ranges from 1 to 366. (The last day of year differs by years.)</p>
<h5 id="example-37"><a href="#example-37">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().ordinal(), <span class="number">251</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).unwrap().ordinal(), <span class="number">74</span>);</code></pre></div>
<p>Combined with <a href="#method.pred"><code>NaiveDate::pred</code></a>,
one can determine the number of days in a particular year.
(Note that this panics when <code>year</code> is out of range.)</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="kw">fn </span>ndays_in_year(year: i32) -> u32 {
<span class="comment">// the first day of the next year...
</span><span class="kw">let </span>d = NaiveDate::from_ymd_opt(year + <span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap();
<span class="comment">// ...is preceded by the last day of the original year
</span>d.pred_opt().unwrap().ordinal()
}
<span class="macro">assert_eq!</span>(ndays_in_year(<span class="number">2015</span>), <span class="number">365</span>);
<span class="macro">assert_eq!</span>(ndays_in_year(<span class="number">2016</span>), <span class="number">366</span>);
<span class="macro">assert_eq!</span>(ndays_in_year(<span class="number">2017</span>), <span class="number">365</span>);
<span class="macro">assert_eq!</span>(ndays_in_year(<span class="number">2000</span>), <span class="number">366</span>);
<span class="macro">assert_eq!</span>(ndays_in_year(<span class="number">2100</span>), <span class="number">365</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.ordinal0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1625-1627">source</a><a href="#method.ordinal0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.ordinal0" class="fn">ordinal0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the day of year starting from 0.</p>
<p>The return value ranges from 0 to 365. (The last day of year differs by years.)</p>
<h5 id="example-38"><a href="#example-38">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().ordinal0(), <span class="number">250</span>);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).unwrap().ordinal0(), <span class="number">73</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.weekday" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1640-1642">source</a><a href="#method.weekday" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.weekday" class="fn">weekday</a>(&self) -> <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a></h4></section></summary><div class="docblock"><p>Returns the day of week.</p>
<h5 id="example-39"><a href="#example-39">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike, Weekday};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().weekday(), Weekday::Tue);
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).unwrap().weekday(), Weekday::Fri);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_year" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1675-1684">source</a><a href="#method.with_year" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_year" class="fn">with_year</a>(&self, year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the year number changed, while keeping the same month and day.</p>
<h5 id="errors-18"><a href="#errors-18">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or when the <code>NaiveDate</code> would be
out of range.</p>
<h5 id="example-40"><a href="#example-40">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_year(<span class="number">2016</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_year(-<span class="number">308</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap()));</code></pre></div>
<p>A leap day (February 29) is a good example that this method can return <code>None</code>.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert!</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).unwrap().with_year(<span class="number">2015</span>).is_none());
<span class="macro">assert!</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).unwrap().with_year(<span class="number">2020</span>).is_some());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_month" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1703-1705">source</a><a href="#method.with_month" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_month" class="fn">with_month</a>(&self, month: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the month number (starting from 1) changed.</p>
<h5 id="errors-19"><a href="#errors-19">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>month</code> is invalid.</p>
<h5 id="example-41"><a href="#example-41">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_month(<span class="number">10</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">8</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_month(<span class="number">13</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13
</span><span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap().with_month(<span class="number">2</span>), <span class="prelude-val">None</span>); <span class="comment">// no February 30</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_month0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1725-1728">source</a><a href="#method.with_month0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_month0" class="fn">with_month0</a>(&self, month0: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the month number (starting from 0) changed.</p>
<h5 id="errors-20"><a href="#errors-20">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>month0</code> is
invalid.</p>
<h5 id="example-42"><a href="#example-42">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_month0(<span class="number">9</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">8</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_month0(<span class="number">12</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13
</span><span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap().with_month0(<span class="number">1</span>), <span class="prelude-val">None</span>); <span class="comment">// no February 30</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_day" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1747-1749">source</a><a href="#method.with_day" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_day" class="fn">with_day</a>(&self, day: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of month (starting from 1) changed.</p>
<h5 id="errors-21"><a href="#errors-21">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>day</code> is invalid.</p>
<h5 id="example-43"><a href="#example-43">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_day(<span class="number">30</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_day(<span class="number">31</span>),
<span class="prelude-val">None</span>); <span class="comment">// no September 31</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_day0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1768-1771">source</a><a href="#method.with_day0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_day0" class="fn">with_day0</a>(&self, day0: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of month (starting from 0) changed.</p>
<h5 id="errors-22"><a href="#errors-22">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>day0</code> is invalid.</p>
<h5 id="example-44"><a href="#example-44">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_day0(<span class="number">29</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().with_day0(<span class="number">30</span>),
<span class="prelude-val">None</span>); <span class="comment">// no September 31</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_ordinal" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1796-1798">source</a><a href="#method.with_ordinal" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_ordinal" class="fn">with_ordinal</a>(&self, ordinal: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of year (starting from 1) changed.</p>
<h5 id="errors-23"><a href="#errors-23">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>ordinal</code> is
invalid.</p>
<h5 id="example-45"><a href="#example-45">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().with_ordinal(<span class="number">60</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().with_ordinal(<span class="number">366</span>),
<span class="prelude-val">None</span>); <span class="comment">// 2015 had only 365 days
</span><span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().with_ordinal(<span class="number">60</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().with_ordinal(<span class="number">366</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap()));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_ordinal0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1823-1826">source</a><a href="#method.with_ordinal0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_ordinal0" class="fn">with_ordinal0</a>(&self, ordinal0: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of year (starting from 0) changed.</p>
<h5 id="errors-24"><a href="#errors-24">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>ordinal0</code> is
invalid.</p>
<h5 id="example-46"><a href="#example-46">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Datelike};
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().with_ordinal0(<span class="number">59</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().with_ordinal0(<span class="number">365</span>),
<span class="prelude-val">None</span>); <span class="comment">// 2015 had only 365 days
</span><span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().with_ordinal0(<span class="number">59</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).unwrap()));
<span class="macro">assert_eq!</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().with_ordinal0(<span class="number">365</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap()));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.iso_week" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1645-1647">source</a><a href="#method.iso_week" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.iso_week" class="fn">iso_week</a>(&self) -> <a class="struct" href="struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></h4></section></summary><div class='docblock'>Returns the ISO week.</div></details><details class="toggle method-toggle" open><summary><section id="method.year_ce" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/traits.rs.html#38-45">source</a><a href="#method.year_ce" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#method.year_ce" class="fn">year_ce</a>(&self) -> (<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a>, <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>)</h4></section></summary><div class='docblock'>Returns the absolute year number starting from 1 with a boolean flag,
which is false when the year predates the epoch (BCE/BC) and true otherwise (CE/AD).</div></details><details class="toggle method-toggle" open><summary><section id="method.num_days_from_ce" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/traits.rs.html#248-263">source</a><a href="#method.num_days_from_ce" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#method.num_days_from_ce" class="fn">num_days_from_ce</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a></h4></section></summary><div class='docblock'>Counts the days in the proleptic Gregorian calendar, with January 1, Year 1 (CE) as day 1. <a href="../trait.Datelike.html#method.num_days_from_ce">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Debug-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2107-2126">source</a><a href="#impl-Debug-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="docblock"><p>The <code>Debug</code> output of the naive date <code>d</code> is the same as
<a href="../format/strftime/index.html"><code>d.format("%Y-%m-%d")</code></a>.</p>
<p>The string printed can be readily parsed via the <code>parse</code> method on <code>str</code>.</p>
<h4 id="example-28"><a href="#example-28">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap()), <span class="string">"2015-09-05"</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, NaiveDate::from_ymd_opt( <span class="number">0</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap()), <span class="string">"0000-01-01"</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, NaiveDate::from_ymd_opt(<span class="number">9999</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap()), <span class="string">"9999-12-31"</span>);</code></pre></div>
<p>ISO 8601 requires an explicit sign for years before 1 BCE or after 9999 CE.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, NaiveDate::from_ymd_opt( -<span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap()), <span class="string">"-0001-01-01"</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, NaiveDate::from_ymd_opt(<span class="number">10000</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap()), <span class="string">"+10000-12-31"</span>);</code></pre></div>
</div><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2108-2125">source</a><a href="#method.fmt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Debug.html#tymethod.fmt" class="fn">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/1.69.0/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Default-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2203-2207">source</a><a href="#impl-Default-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/default/trait.Default.html" title="trait core::default::Default">Default</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="docblock"><p>The default value for a NaiveDate is 1st of January 1970.</p>
<h4 id="example-49"><a href="#example-49">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>default_date = NaiveDate::default();
<span class="macro">assert_eq!</span>(default_date, NaiveDate::from_ymd_opt(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap());</code></pre></div>
</div><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.default" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2204-2206">source</a><a href="#method.default" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/default/trait.Default.html#tymethod.default" class="fn">default</a>() -> Self</h4></section></summary><div class='docblock'>Returns the “default value” for a type. <a href="https://doc.rust-lang.org/1.69.0/core/default/trait.Default.html#tymethod.default">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Display-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2150-2154">source</a><a href="#impl-Display-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="docblock"><p>The <code>Display</code> output of the naive date <code>d</code> is the same as
<a href="../format/strftime/index.html"><code>d.format("%Y-%m-%d")</code></a>.</p>
<p>The string printed can be readily parsed via the <code>parse</code> method on <code>str</code>.</p>
<h4 id="example-31"><a href="#example-31">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap()), <span class="string">"2015-09-05"</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, NaiveDate::from_ymd_opt( <span class="number">0</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap()), <span class="string">"0000-01-01"</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, NaiveDate::from_ymd_opt(<span class="number">9999</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap()), <span class="string">"9999-12-31"</span>);</code></pre></div>
<p>ISO 8601 requires an explicit sign for years before 1 BCE or after 9999 CE.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, NaiveDate::from_ymd_opt( -<span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap()), <span class="string">"-0001-01-01"</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, NaiveDate::from_ymd_opt(<span class="number">10000</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap()), <span class="string">"+10000-12-31"</span>);</code></pre></div>
</div><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.fmt-1" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2151-2153">source</a><a href="#method.fmt-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Display.html#tymethod.fmt" class="fn">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/1.69.0/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Display.html#tymethod.fmt">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-From%3CNaiveDateTime%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2010-2014">source</a><a href="#impl-From%3CNaiveDateTime%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.from" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2011-2013">source</a><a href="#method.from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html#tymethod.from" class="fn">from</a>(naive_datetime: <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> Self</h4></section></summary><div class='docblock'>Converts to this type from the input type.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-FromStr-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2172-2191">source</a><a href="#impl-FromStr-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/str/traits/trait.FromStr.html" title="trait core::str::traits::FromStr">FromStr</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="docblock"><p>Parsing a <code>str</code> into a <code>NaiveDate</code> uses the same format,
<a href="../format/strftime/index.html"><code>%Y-%m-%d</code></a>, as in <code>Debug</code> and <code>Display</code>.</p>
<h4 id="example-26"><a href="#example-26">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">18</span>).unwrap();
<span class="macro">assert_eq!</span>(<span class="string">"2015-09-18"</span>.parse::<NaiveDate>(), <span class="prelude-val">Ok</span>(d));
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">12345</span>, <span class="number">6</span>, <span class="number">7</span>).unwrap();
<span class="macro">assert_eq!</span>(<span class="string">"+12345-6-7"</span>.parse::<NaiveDate>(), <span class="prelude-val">Ok</span>(d));
<span class="macro">assert!</span>(<span class="string">"foo"</span>.parse::<NaiveDate>().is_err());</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Err" class="associatedtype trait-impl"><a href="#associatedtype.Err" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/str/traits/trait.FromStr.html#associatedtype.Err" class="associatedtype">Err</a> = <a class="struct" href="../format/struct.ParseError.html" title="struct chrono::format::ParseError">ParseError</a></h4></section></summary><div class='docblock'>The associated error which can be returned from parsing.</div></details><details class="toggle method-toggle" open><summary><section id="method.from_str" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2175-2190">source</a><a href="#method.from_str" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/str/traits/trait.FromStr.html#tymethod.from_str" class="fn">from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>) -> <a class="type" href="../format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></h4></section></summary><div class='docblock'>Parses a string <code>s</code> to return a value of this type. <a href="https://doc.rust-lang.org/1.69.0/core/str/traits/trait.FromStr.html#tymethod.from_str">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Hash-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-Hash-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.hash" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#method.hash" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html#tymethod.hash" class="fn">hash</a><__H: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>>(&self, state: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&mut __H</a>)</h4></section></summary><div class='docblock'>Feeds this value into the given <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html#tymethod.hash">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.hash_slice" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.3.0">1.3.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/hash/mod.rs.html#239-241">source</a></span><a href="#method.hash_slice" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html#method.hash_slice" class="fn">hash_slice</a><H>(data: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.slice.html">[Self]</a>, state: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&mut H</a>)<span class="where fmt-newline">where
H: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>,
Self: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h4></section></summary><div class='docblock'>Feeds a slice of this type into the given <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html#method.hash_slice">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Ord-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-Ord-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html" title="trait core::cmp::Ord">Ord</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.cmp" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#method.cmp" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#tymethod.cmp" class="fn">cmp</a>(&self, other: &<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a></h4></section></summary><div class='docblock'>This method returns an <a href="https://doc.rust-lang.org/1.69.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering"><code>Ordering</code></a> between <code>self</code> and <code>other</code>. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#tymethod.cmp">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.max" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#798-801">source</a></span><a href="#method.max" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.max" class="fn">max</a>(self, other: Self) -> Self<span class="where fmt-newline">where
Self: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h4></section></summary><div class='docblock'>Compares and returns the maximum of two values. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.max">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.min" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#822-825">source</a></span><a href="#method.min" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.min" class="fn">min</a>(self, other: Self) -> Self<span class="where fmt-newline">where
Self: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h4></section></summary><div class='docblock'>Compares and returns the minimum of two values. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.min">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clamp" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.50.0">1.50.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#851-855">source</a></span><a href="#method.clamp" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.clamp" class="fn">clamp</a>(self, min: Self, max: Self) -> Self<span class="where fmt-newline">where
Self: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a> + <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a><Self>,</span></h4></section></summary><div class='docblock'>Restrict a value to a certain interval. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.clamp">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-PartialEq%3CNaiveDate%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-PartialEq%3CNaiveDate%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialEq.html" title="trait core::cmp::PartialEq">PartialEq</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.eq" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#method.eq" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialEq.html#tymethod.eq" class="fn">eq</a>(&self, other: &<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></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>.</div></details><details class="toggle method-toggle" open><summary><section id="method.ne" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#229">source</a></span><a href="#method.ne" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialEq.html#method.ne" class="fn">ne</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></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.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-PartialOrd%3CNaiveDate%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-PartialOrd%3CNaiveDate%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.partial_cmp" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#method.partial_cmp" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp" class="fn">partial_cmp</a>(&self, other: &<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="enum" href="https://doc.rust-lang.org/1.69.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a>></h4></section></summary><div class='docblock'>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.lt" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#1086">source</a></span><a href="#method.lt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.lt" class="fn">lt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code><</code> operator. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.lt">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.le" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#1105">source</a></span><a href="#method.le" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.le" class="fn">le</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code><=</code>
operator. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.le">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.gt" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#1123">source</a></span><a href="#method.gt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.gt" class="fn">gt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>></code> operator. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.gt">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.ge" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#1142">source</a></span><a href="#method.ge" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.ge" class="fn">ge</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>>=</code>
operator. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.ge">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CDays%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1929-1935">source</a><a href="#impl-Sub%3CDays%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output" class="associatedtype trait-impl"><a href="#associatedtype.Output" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1932-1934">source</a><a href="#method.sub" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, days: <a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>) -> Self::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" title="type core::ops::arith::Sub::Output">Output</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CDuration%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1961-1968">source</a><a href="#impl-Sub%3CDuration%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="docblock"><p>A subtraction of <code>Duration</code> from <code>NaiveDate</code> discards the fractional days,
rounding to the closest integral number of days towards <code>Duration::zero()</code>.
It is the same as the addition with a negated <code>Duration</code>.</p>
<p>Panics on underflow or overflow. Use <a href="struct.NaiveDate.html#method.checked_sub_signed" title="method chrono::naive::NaiveDate::checked_sub_signed"><code>NaiveDate::checked_sub_signed</code></a> to detect that.</p>
<h4 id="example-27"><a href="#example-27">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Duration::zero(), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Duration::seconds(<span class="number">86399</span>), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Duration::seconds(-<span class="number">86399</span>), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Duration::days(<span class="number">1</span>), from_ymd(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Duration::days(-<span class="number">1</span>), from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Duration::days(<span class="number">364</span>), from_ymd(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">2</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Duration::days(<span class="number">365</span><span class="kw-2">*</span><span class="number">4 </span>+ <span class="number">1</span>), from_ymd(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Duration::days(<span class="number">365</span><span class="kw-2">*</span><span class="number">400 </span>+ <span class="number">97</span>), from_ymd(<span class="number">1614</span>, <span class="number">1</span>, <span class="number">1</span>));</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-2" class="associatedtype trait-impl"><a href="#associatedtype.Output-2" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub-1" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1965-1967">source</a><a href="#method.sub-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CMonths%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1896-1919">source</a><a href="#impl-Sub%3CMonths%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.sub-3" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1916-1918">source</a><a href="#method.sub-3" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, months: <a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>) -> Self::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" title="type core::ops::arith::Sub::Output">Output</a></h4></section></summary><div class="docblock"><p>A subtraction of Months from <code>NaiveDate</code> clamped to valid days in resulting month.</p>
<h5 id="panics-12"><a href="#panics-12">Panics</a></h5>
<p>Panics if the resulting date would be out of range.</p>
<h5 id="example-47"><a href="#example-47">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Months};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Months::new(<span class="number">11</span>), from_ymd(<span class="number">2013</span>, <span class="number">2</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Months::new(<span class="number">12</span>), from_ymd(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - Months::new(<span class="number">13</span>), from_ymd(<span class="number">2012</span>, <span class="number">12</span>, <span class="number">1</span>));</code></pre></div>
</div></details><details class="toggle" open><summary><section id="associatedtype.Output-5" class="associatedtype trait-impl"><a href="#associatedtype.Output-5" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CNaiveDate%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2001-2008">source</a><a href="#impl-Sub%3CNaiveDate%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="docblock"><p>Subtracts another <code>NaiveDate</code> from the current date.
Returns a <code>Duration</code> of integral numbers.</p>
<p>This does not overflow or underflow at all,
as all possible output fits in the range of <code>Duration</code>.</p>
<p>The implementation is a wrapper around
<a href="#method.signed_duration_since"><code>NaiveDate::signed_duration_since</code></a>.</p>
<h4 id="example-30"><a href="#example-30">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), Duration::zero());
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - from_ymd(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>), Duration::days(<span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>), Duration::days(-<span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - from_ymd(<span class="number">2013</span>, <span class="number">9</span>, <span class="number">23</span>), Duration::days(<span class="number">100</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - from_ymd(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">1</span>), Duration::days(<span class="number">365</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - from_ymd(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>), Duration::days(<span class="number">365</span><span class="kw-2">*</span><span class="number">4 </span>+ <span class="number">1</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) - from_ymd(<span class="number">1614</span>, <span class="number">1</span>, <span class="number">1</span>), Duration::days(<span class="number">365</span><span class="kw-2">*</span><span class="number">400 </span>+ <span class="number">97</span>));</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-4" class="associatedtype trait-impl"><a href="#associatedtype.Output-4" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub-2" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2005-2007">source</a><a href="#method.sub-2" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, rhs: <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-SubAssign%3CDuration%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1970-1975">source</a><a href="#impl-SubAssign%3CDuration%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html" title="trait core::ops::arith::SubAssign">SubAssign</a><<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.sub_assign" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#1972-1974">source</a><a href="#method.sub_assign" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign" class="fn">sub_assign</a>(&mut self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</h4></section></summary><div class='docblock'>Performs the <code>-=</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign">Read more</a></div></details></div></details><section id="impl-Copy-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-Copy-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Copy.html" title="trait core::marker::Copy">Copy</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section><section id="impl-Eq-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-Eq-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section><section id="impl-StructuralEq-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-StructuralEq-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.StructuralEq.html" title="trait core::marker::StructuralEq">StructuralEq</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section><section id="impl-StructuralPartialEq-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#193">source</a><a href="#impl-StructuralPartialEq-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.StructuralPartialEq.html" title="trait core::marker::StructuralPartialEq">StructuralPartialEq</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</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-NaiveDate" class="impl"><a href="#impl-RefUnwindSafe-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section><section id="impl-Send-for-NaiveDate" class="impl"><a href="#impl-Send-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section><section id="impl-Sync-for-NaiveDate" class="impl"><a href="#impl-Sync-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section><section id="impl-Unpin-for-NaiveDate" class="impl"><a href="#impl-Unpin-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section><section id="impl-UnwindSafe-for-NaiveDate" class="impl"><a href="#impl-UnwindSafe-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/panic/unwind_safe/trait.UnwindSafe.html" title="trait core::panic::unwind_safe::UnwindSafe">UnwindSafe</a> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</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="toggle implementors-toggle"><summary><section id="impl-Any-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/any.rs.html#200">source</a><a href="#impl-Any-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T<span class="where fmt-newline">where
T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/any.rs.html#201">source</a><a href="#method.type_id" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/any/trait.Any.html#tymethod.type_id" class="fn">type_id</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/1.69.0/core/any/trait.Any.html#tymethod.type_id">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/borrow.rs.html#211">source</a><a href="#impl-Borrow%3CT%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><T> for T<span class="where fmt-newline">where
T: ?<a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/borrow.rs.html#213">source</a></span><a href="#method.borrow" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.Borrow.html#tymethod.borrow" class="fn">borrow</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&T</a></h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/borrow.rs.html#220">source</a><a href="#impl-BorrowMut%3CT%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a><T> for T<span class="where fmt-newline">where
T: ?<a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/borrow.rs.html#221">source</a></span><a href="#method.borrow_mut" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fn">borrow_mut</a>(&mut self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&mut T</a></h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#733">source</a><a href="#impl-From%3CT%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for T</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.from-1" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#736">source</a></span><a href="#method.from-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html#tymethod.from" class="fn">from</a>(t: T) -> T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#717">source</a><a href="#impl-Into%3CU%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><U> for T<span class="where fmt-newline">where
U: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.into" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#725">source</a></span><a href="#method.into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.Into.html#tymethod.into" class="fn">into</a>(self) -> U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p>
<p>That is, this conversion is whatever the implementation of
<code><a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for U</code> chooses to do.</p>
</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-ToOwned-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/borrow.rs.html#82">source</a><a href="#impl-ToOwned-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T<span class="where fmt-newline">where
T: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Owned" class="associatedtype trait-impl"><a href="#associatedtype.Owned" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="associatedtype">Owned</a> = T</h4></section></summary><div class='docblock'>The resulting type after obtaining ownership.</div></details><details class="toggle method-toggle" open><summary><section id="method.to_owned" class="method trait-impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/borrow.rs.html#87">source</a><a href="#method.to_owned" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fn">to_owned</a>(&self) -> T</h4></section></summary><div class='docblock'>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clone_into" class="method trait-impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/borrow.rs.html#91">source</a><a href="#method.clone_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fn">clone_into</a>(&self, target: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&mut T</a>)</h4></section></summary><div class='docblock'>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-ToString-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/string.rs.html#2522">source</a><a href="#impl-ToString-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/alloc/string/trait.ToString.html" title="trait alloc::string::ToString">ToString</a> for T<span class="where fmt-newline">where
T: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + ?<a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.to_string" class="method trait-impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/string.rs.html#2528">source</a><a href="#method.to_string" class="anchor">§</a><h4 class="code-header">default fn <a href="https://doc.rust-lang.org/1.69.0/alloc/string/trait.ToString.html#tymethod.to_string" class="fn">to_string</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/1.69.0/alloc/string/struct.String.html" title="struct alloc::string::String">String</a></h4></section></summary><div class='docblock'>Converts the given value to a <code>String</code>. <a href="https://doc.rust-lang.org/1.69.0/alloc/string/trait.ToString.html#tymethod.to_string">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#775">source</a><a href="#impl-TryFrom%3CU%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U> for T<span class="where fmt-newline">where
U: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><T>,</span></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Error-1" class="associatedtype trait-impl"><a href="#associatedtype.Error-1" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#associatedtype.Error" class="associatedtype">Error</a> = <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#781">source</a></span><a href="#method.try_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#tymethod.try_from" class="fn">try_from</a>(value: U) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><T, <T as <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#760">source</a><a href="#impl-TryInto%3CU%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a><U> for T<span class="where fmt-newline">where
U: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>,</span></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Error" class="associatedtype trait-impl"><a href="#associatedtype.Error" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryInto.html#associatedtype.Error" class="associatedtype">Error</a> = <U as <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#766">source</a></span><a href="#method.try_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryInto.html#tymethod.try_into" class="fn">try_into</a>(self) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><U, <U as <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details></div><script type="text/json" id="notable-traits-data">{"NaiveDateDaysIterator":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.NaiveDateDaysIterator.html\" title=\"struct chrono::naive::NaiveDateDaysIterator\">NaiveDateDaysIterator</a></code></h3><pre><code><span class=\"where fmt-newline\">impl <a class=\"trait\" href=\"https://doc.rust-lang.org/1.69.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.NaiveDateDaysIterator.html\" title=\"struct chrono::naive::NaiveDateDaysIterator\">NaiveDateDaysIterator</a></span><span class=\"where fmt-newline\"> type <a href=\"https://doc.rust-lang.org/1.69.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = <a class=\"struct\" href=\"struct.NaiveDate.html\" title=\"struct chrono::naive::NaiveDate\">NaiveDate</a>;</span>","NaiveDateWeeksIterator":"<h3>Notable traits for <code><a class=\"struct\" href=\"struct.NaiveDateWeeksIterator.html\" title=\"struct chrono::naive::NaiveDateWeeksIterator\">NaiveDateWeeksIterator</a></code></h3><pre><code><span class=\"where fmt-newline\">impl <a class=\"trait\" href=\"https://doc.rust-lang.org/1.69.0/core/iter/traits/iterator/trait.Iterator.html\" title=\"trait core::iter::traits::iterator::Iterator\">Iterator</a> for <a class=\"struct\" href=\"struct.NaiveDateWeeksIterator.html\" title=\"struct chrono::naive::NaiveDateWeeksIterator\">NaiveDateWeeksIterator</a></span><span class=\"where fmt-newline\"> type <a href=\"https://doc.rust-lang.org/1.69.0/core/iter/traits/iterator/trait.Iterator.html#associatedtype.Item\" class=\"associatedtype\">Item</a> = <a class=\"struct\" href=\"struct.NaiveDate.html\" title=\"struct chrono::naive::NaiveDate\">NaiveDate</a>;</span>"}</script></section></div></main><div id="rustdoc-vars" data-root-path="../../" data-static-root-path="../../static.files/" data-current-crate="chrono" data-themes="" data-resource-suffix="" data-rustdoc-version="1.69.0 (84c898d65 2023-04-16) (built from a source tarball)" data-search-js="search-8a59a8356673ec1f.js" data-settings-js="settings-f0c5c39777a9a2f6.js" data-settings-css="settings-0bcba95ff279c1db.css" ></div></body></html>