834 lines
216 KiB
HTML
834 lines
216 KiB
HTML
<!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."><meta name="keywords" content="rust, rustlang, rust-lang, NaiveDate"><title>NaiveDate in chrono::naive - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled><link rel="stylesheet" type="text/css" href="../../dark.css" disabled><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../../storage.js"></script><script src="../../crates.js"></script><script defer src="../../main.js"></script>
|
||
<noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="alternate icon" type="image/png" href="../../favicon-16x16.png"><link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><link rel="icon" type="image/svg+xml" href="../../favicon.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="sidebar"><div class="sidebar-menu" role="button">☰</div><a class="sidebar-logo" href="../../chrono/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.png" alt="logo"></div>
|
||
</a><h2 class="location">Struct NaiveDate</h2><div class="sidebar-elems"><div class="block items"><h3 class="sidebar-title"><a href="#implementations">Methods</a></h3><div class="sidebar-links"><a href="#method.and_hms">and_hms</a><a href="#method.and_hms_micro">and_hms_micro</a><a href="#method.and_hms_micro_opt">and_hms_micro_opt</a><a href="#method.and_hms_milli">and_hms_milli</a><a href="#method.and_hms_milli_opt">and_hms_milli_opt</a><a href="#method.and_hms_nano">and_hms_nano</a><a href="#method.and_hms_nano_opt">and_hms_nano_opt</a><a href="#method.and_hms_opt">and_hms_opt</a><a href="#method.and_time">and_time</a><a href="#method.checked_add_signed">checked_add_signed</a><a href="#method.checked_sub_signed">checked_sub_signed</a><a href="#method.format">format</a><a href="#method.format_with_items">format_with_items</a><a href="#method.from_isoywd">from_isoywd</a><a href="#method.from_isoywd_opt">from_isoywd_opt</a><a href="#method.from_num_days_from_ce">from_num_days_from_ce</a><a href="#method.from_num_days_from_ce_opt">from_num_days_from_ce_opt</a><a href="#method.from_weekday_of_month">from_weekday_of_month</a><a href="#method.from_weekday_of_month_opt">from_weekday_of_month_opt</a><a href="#method.from_ymd">from_ymd</a><a href="#method.from_ymd_opt">from_ymd_opt</a><a href="#method.from_yo">from_yo</a><a href="#method.from_yo_opt">from_yo_opt</a><a href="#method.iter_days">iter_days</a><a href="#method.iter_weeks">iter_weeks</a><a href="#method.parse_from_str">parse_from_str</a><a href="#method.pred">pred</a><a href="#method.pred_opt">pred_opt</a><a href="#method.signed_duration_since">signed_duration_since</a><a href="#method.succ">succ</a><a href="#method.succ_opt">succ_opt</a></div><h3 class="sidebar-title"><a href="#trait-implementations">Trait Implementations</a></h3><div class="sidebar-links"><a href="#impl-Add%3CDuration%3E">Add<Duration></a><a href="#impl-AddAssign%3CDuration%3E">AddAssign<Duration></a><a href="#impl-Clone">Clone</a><a href="#impl-Copy">Copy</a><a href="#impl-Datelike">Datelike</a><a href="#impl-Debug">Debug</a><a href="#impl-Display">Display</a><a href="#impl-Eq">Eq</a><a href="#impl-FromStr">FromStr</a><a href="#impl-Hash">Hash</a><a href="#impl-Ord">Ord</a><a href="#impl-PartialEq%3CNaiveDate%3E">PartialEq<NaiveDate></a><a href="#impl-PartialOrd%3CNaiveDate%3E">PartialOrd<NaiveDate></a><a href="#impl-StructuralEq">StructuralEq</a><a href="#impl-StructuralPartialEq">StructuralPartialEq</a><a href="#impl-Sub%3CDuration%3E">Sub<Duration></a><a href="#impl-Sub%3CNaiveDate%3E">Sub<NaiveDate></a><a href="#impl-SubAssign%3CDuration%3E">SubAssign<Duration></a></div><h3 class="sidebar-title"><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><div class="sidebar-links"><a href="#impl-RefUnwindSafe">RefUnwindSafe</a><a href="#impl-Send">Send</a><a href="#impl-Sync">Sync</a><a href="#impl-Unpin">Unpin</a><a href="#impl-UnwindSafe">UnwindSafe</a></div><h3 class="sidebar-title"><a href="#blanket-implementations">Blanket Implementations</a></h3><div class="sidebar-links"><a href="#impl-Any">Any</a><a href="#impl-Borrow%3CT%3E">Borrow<T></a><a href="#impl-BorrowMut%3CT%3E">BorrowMut<T></a><a href="#impl-From%3CT%3E">From<T></a><a href="#impl-Into%3CU%3E">Into<U></a><a href="#impl-ToOwned">ToOwned</a><a href="#impl-ToString">ToString</a><a href="#impl-TryFrom%3CU%3E">TryFrom<U></a><a href="#impl-TryInto%3CU%3E">TryInto<U></a></div></div><h2 class="location">Other items in<br><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></h2><div id="sidebar-vars" data-name="NaiveDate" data-ty="struct" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><main><div class="width-limiter"><div class="sub-container"><a class="sub-logo-container" href="../../chrono/index.html"><img class="rust-logo" src="../../rust-logo.png" alt="logo"></a><nav class="sub"><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu" title="themes"><img width="18" height="18" alt="Pick another theme!" src="../../brush.svg"></button><div id="theme-choices" role="menu"></div></div><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" id="help-button" title="help">?</button><a id="settings-menu" href="../../settings.html" title="settings"><img width="18" height="18" alt="Change settings" src="../../wheel.svg"></a></div></form></nav></div><section id="main-content" class="content"><h1 class="fqn"><span class="in-band">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" onclick="copy_path(this)" title="Copy item path to clipboard"><img src="../../clipboard.svg" width="19" height="18" alt="Copy item path"></button></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/date.rs.html#99-101" title="goto source code">[src]</a></span></h1><div class="docblock item-decl"><pre class="rust struct"><code>pub struct NaiveDate { /* fields omitted */ }</code></pre></div><details class="rustdoc-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="#calendar-date">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" class="section-header"><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" class="section-header"><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" class="section-header"><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><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#136-1100" title="goto source code">[src]</a></div><a href="#impl" class="anchor"></a><h3 class="code-header in-band">impl <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_ymd" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#172-174" title="goto source code">[src]</a></div><a href="#method.from_ymd" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_ymd" class="fnname">from_ymd</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>, month: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, day: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></div></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>
|
||
<p>Panics on the out-of-range date, invalid month and/or day.</p>
|
||
<h5 id="example" class="section-header"><a href="#example">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">14</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">month</span>(), <span class="number">3</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">day</span>(), <span class="number">14</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">ordinal</span>(), <span class="number">73</span>); <span class="comment">// day of year</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">11</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Sat</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">num_days_from_ce</span>(), <span class="number">735671</span>); <span class="comment">// days since January 1, 1 CE</span></code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_ymd_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#195-198" title="goto source code">[src]</a></div><a href="#method.from_ymd_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_ymd_opt" class="fnname">from_ymd_opt</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>, month: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, day: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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>
|
||
<p>Returns <code>None</code> on the out-of-range date, invalid month and/or day.</p>
|
||
<h5 id="example-1" class="section-header"><a href="#example-1">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">from_ymd_opt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd_opt</span>;
|
||
|
||
<span class="macro">assert!</span>(<span class="ident">from_ymd_opt</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">is_some</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_ymd_opt</span>(<span class="number">2015</span>, <span class="number">0</span>, <span class="number">14</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_ymd_opt</span>(<span class="number">2015</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_ymd_opt</span>(<span class="op">-</span><span class="number">4</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">is_some</span>()); <span class="comment">// 5 BCE is a leap year</span>
|
||
<span class="macro">assert!</span>(<span class="ident">from_ymd_opt</span>(<span class="number">400000</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_ymd_opt</span>(<span class="op">-</span><span class="number">400000</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">is_none</span>());</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_yo" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#220-222" title="goto source code">[src]</a></div><a href="#method.from_yo" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_yo" class="fnname">from_yo</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>, ordinal: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></div></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>
|
||
<p>Panics on the out-of-range date and/or invalid day of year.</p>
|
||
<h5 id="example-2" class="section-header"><a href="#example-2">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_yo</span>(<span class="number">2015</span>, <span class="number">73</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">ordinal</span>(), <span class="number">73</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">month</span>(), <span class="number">3</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">day</span>(), <span class="number">14</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">11</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Sat</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">num_days_from_ce</span>(), <span class="number">735671</span>); <span class="comment">// days since January 1, 1 CE</span></code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_yo_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#244-247" title="goto source code">[src]</a></div><a href="#method.from_yo_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_yo_opt" class="fnname">from_yo_opt</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>, ordinal: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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>
|
||
<p>Returns <code>None</code> on the out-of-range date and/or invalid day of year.</p>
|
||
<h5 id="example-3" class="section-header"><a href="#example-3">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">from_yo_opt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_yo_opt</span>;
|
||
|
||
<span class="macro">assert!</span>(<span class="ident">from_yo_opt</span>(<span class="number">2015</span>, <span class="number">100</span>).<span class="ident">is_some</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_yo_opt</span>(<span class="number">2015</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_yo_opt</span>(<span class="number">2015</span>, <span class="number">365</span>).<span class="ident">is_some</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_yo_opt</span>(<span class="number">2015</span>, <span class="number">366</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_yo_opt</span>(<span class="op">-</span><span class="number">4</span>, <span class="number">366</span>).<span class="ident">is_some</span>()); <span class="comment">// 5 BCE is a leap year</span>
|
||
<span class="macro">assert!</span>(<span class="ident">from_yo_opt</span>(<span class="number">400000</span>, <span class="number">1</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">from_yo_opt</span>(<span class="op">-</span><span class="number">400000</span>, <span class="number">1</span>).<span class="ident">is_none</span>());</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_isoywd" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#270-272" title="goto source code">[src]</a></div><a href="#method.from_isoywd" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_isoywd" class="fnname">from_isoywd</a>(year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>, week: <a class="primitive" href="https://doc.rust-lang.org/1.59.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></div></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>
|
||
<p>Panics on the out-of-range date and/or invalid week number.</p>
|
||
<h5 id="example-4" class="section-header"><a href="#example-4">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_isoywd</span>(<span class="number">2015</span>, <span class="number">11</span>, <span class="ident">Weekday::Sat</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">11</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Sat</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">month</span>(), <span class="number">3</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">day</span>(), <span class="number">14</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">ordinal</span>(), <span class="number">73</span>); <span class="comment">// day of year</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">num_days_from_ce</span>(), <span class="number">735671</span>); <span class="comment">// days since January 1, 1 CE</span></code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_isoywd_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#318-347" title="goto source code">[src]</a></div><a href="#method.from_isoywd_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_isoywd_opt" class="fnname">from_isoywd_opt</a>(<br> year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>, <br> week: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> weekday: <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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>
|
||
<p>Returns <code>None</code> on the out-of-range date and/or invalid week number.</p>
|
||
<h5 id="example-5" class="section-header"><a href="#example-5">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>;
|
||
<span class="kw">let</span> <span class="ident">from_isoywd_opt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_isoywd_opt</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">0</span>, <span class="ident">Weekday::Sun</span>), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="ident">Weekday::Sun</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">8</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">30</span>, <span class="ident">Weekday::Mon</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">20</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">60</span>, <span class="ident">Weekday::Mon</span>), <span class="prelude-val">None</span>);
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">400000</span>, <span class="number">10</span>, <span class="ident">Weekday::Fri</span>), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="op">-</span><span class="number">400000</span>, <span class="number">10</span>, <span class="ident">Weekday::Sat</span>), <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</span>
|
||
<span class="comment">// 2014-W52 22 23 24 25 26 27 28 has 4+ days of new year,</span>
|
||
<span class="comment">// 2015-W01 29 30 31 1 2 3 4 <- so this is the first week</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2014</span>, <span class="number">52</span>, <span class="ident">Weekday::Sun</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">28</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2014</span>, <span class="number">53</span>, <span class="ident">Weekday::Mon</span>), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="ident">Weekday::Mon</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<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,</span>
|
||
<span class="comment">// 2015-W53 28 29 30 31 1 2 3 <- so this is the last week</span>
|
||
<span class="comment">// 2016-W01 4 5 6 7 8 9 10</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">52</span>, <span class="ident">Weekday::Sun</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">12</span>, <span class="number">27</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">53</span>, <span class="ident">Weekday::Sun</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">3</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">54</span>, <span class="ident">Weekday::Mon</span>), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="ident">Weekday::Mon</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">4</span>)));</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_num_days_from_ce" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#393-395" title="goto source code">[src]</a></div><a href="#method.from_num_days_from_ce" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_num_days_from_ce" class="fnname">from_num_days_from_ce</a>(days: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></div></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>
|
||
<p>Panics if the date is out of range.</p>
|
||
<h5 id="example-6" class="section-header"><a href="#example-6">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_num_days_from_ce</span>(<span class="number">735671</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">num_days_from_ce</span>(), <span class="number">735671</span>); <span class="comment">// days since January 1, 1 CE</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">month</span>(), <span class="number">3</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">day</span>(), <span class="number">14</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">ordinal</span>(), <span class="number">73</span>); <span class="comment">// day of year</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">11</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Sat</span>);</code></pre></div>
|
||
<p>While not directly supported by Chrono,
|
||
it is easy to convert from the Julian day number
|
||
(January 1, 4713 BCE in the <em>Julian</em> calendar being Day 0)
|
||
to Gregorian with this method.
|
||
(Note that this panics when <code>jd</code> is out of range.)</p>
|
||
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">fn</span> <span class="ident">jd_to_date</span>(<span class="ident">jd</span>: <span class="ident">i32</span>) -> <span class="ident">NaiveDate</span> {
|
||
<span class="comment">// keep in mind that the Julian day number is 0-based</span>
|
||
<span class="comment">// while this method requires an 1-based number.</span>
|
||
<span class="ident">NaiveDate::from_num_days_from_ce</span>(<span class="ident">jd</span> <span class="op">-</span> <span class="number">1721425</span>)
|
||
}
|
||
|
||
<span class="comment">// January 1, 4713 BCE in Julian = November 24, 4714 BCE in Gregorian</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">jd_to_date</span>(<span class="number">0</span>), <span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">4713</span>, <span class="number">11</span>, <span class="number">24</span>));
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">jd_to_date</span>(<span class="number">1721426</span>), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">jd_to_date</span>(<span class="number">2450000</span>), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">1995</span>, <span class="number">10</span>, <span class="number">9</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">jd_to_date</span>(<span class="number">2451545</span>), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2000</span>, <span class="number">1</span>, <span class="number">1</span>));</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_num_days_from_ce_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#417-423" title="goto source code">[src]</a></div><a href="#method.from_num_days_from_ce_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_num_days_from_ce_opt" class="fnname">from_num_days_from_ce_opt</a>(days: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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>
|
||
<p>Returns <code>None</code> if the date is out of range.</p>
|
||
<h5 id="example-7" class="section-header"><a href="#example-7">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">from_ndays_opt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_num_days_from_ce_opt</span>;
|
||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ndays_opt</span>(<span class="number">730_000</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">1999</span>, <span class="number">9</span>, <span class="number">3</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ndays_opt</span>(<span class="number">1</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ndays_opt</span>(<span class="number">0</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">0</span>, <span class="number">12</span>, <span class="number">31</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ndays_opt</span>(<span class="op">-</span><span class="number">1</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">0</span>, <span class="number">12</span>, <span class="number">30</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ndays_opt</span>(<span class="number">100_000_000</span>), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ndays_opt</span>(<span class="op">-</span><span class="number">100_000_000</span>), <span class="prelude-val">None</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_weekday_of_month" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#450-452" title="goto source code">[src]</a></div><a href="#method.from_weekday_of_month" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_weekday_of_month" class="fnname">from_weekday_of_month</a>(<br> year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>, <br> month: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> weekday: <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>, <br> n: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u8.html">u8</a><br>) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></div></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>
|
||
<h5 id="panics" class="section-header"><a href="#panics">Panics</a></h5>
|
||
<p>The resulting <code>NaiveDate</code> is guaranteed to be in <code>month</code>. If <code>n</code> is larger than the number
|
||
of <code>weekday</code> in <code>month</code> (eg. the 6th Friday of March 2017) then this function will panic.</p>
|
||
<p><code>n</code> is 1-indexed. Passing <code>n=0</code> will cause a panic.</p>
|
||
<h5 id="example-8" class="section-header"><a href="#example-8">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">from_weekday_of_month</span> <span class="op">=</span> <span class="ident">NaiveDate::from_weekday_of_month</span>;
|
||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday::Wed</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday::Fri</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">3</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday::Tue</span>, <span class="number">2</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">14</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday::Fri</span>, <span class="number">4</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">24</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday::Fri</span>, <span class="number">5</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">31</span>));</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_weekday_of_month_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#466-479" title="goto source code">[src]</a></div><a href="#method.from_weekday_of_month_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_weekday_of_month_opt" class="fnname">from_weekday_of_month_opt</a>(<br> year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>, <br> month: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> weekday: <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>, <br> n: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u8.html">u8</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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>. <code>n</code> is 1-indexed.</p>
|
||
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Weekday</span>};
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_weekday_of_month_opt</span>(<span class="number">2017</span>, <span class="number">3</span>, <span class="ident">Weekday::Fri</span>, <span class="number">2</span>),
|
||
<span class="ident">NaiveDate::from_ymd_opt</span>(<span class="number">2017</span>, <span class="number">3</span>, <span class="number">10</span>))</code></pre></div>
|
||
<p>Returns <code>None</code> if <code>n</code> out-of-range; ie. if <code>n</code> is larger than the number of <code>weekday</code> in
|
||
<code>month</code> (eg. the 6th Friday of March 2017), or if <code>n == 0</code>.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.parse_from_str" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#523-527" title="goto source code">[src]</a></div><a href="#method.parse_from_str" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.parse_from_str" class="fnname">parse_from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.str.html">str</a>, fmt: &<a class="primitive" href="https://doc.rust-lang.org/1.59.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></div></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-9" class="section-header"><a href="#example-9">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">parse_from_str</span> <span class="op">=</span> <span class="ident">NaiveDate::parse_from_str</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2015-09-05"</span>, <span class="string">"%Y-%m-%d"</span>),
|
||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">parse_from_str</span>(<span class="string">"5sep2015"</span>, <span class="string">"%d%b%Y"</span>),
|
||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>)));</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>(<span class="ident">parse_from_str</span>(<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>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2014</span>, <span class="number">5</span>, <span class="number">17</span>)));</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>(<span class="ident">parse_from_str</span>(<span class="string">"2015/9"</span>, <span class="string">"%Y/%m"</span>).<span class="ident">is_err</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2015/9/31"</span>, <span class="string">"%Y/%m/%d"</span>).<span class="ident">is_err</span>());</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>(<span class="ident">parse_from_str</span>(<span class="string">"Sat, 09 Aug 2013"</span>, <span class="string">"%a, %d %b %Y"</span>).<span class="ident">is_err</span>());</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_time" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#544-546" title="goto source code">[src]</a></div><a href="#method.and_time" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_time" class="fnname">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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date and given <code>NaiveTime</code>.</p>
|
||
<h5 id="example-10" class="section-header"><a href="#example-10">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveTime</span>, <span class="ident">NaiveDateTime</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime::from_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||
|
||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_time</span>(<span class="ident">t</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">date</span>(), <span class="ident">d</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">time</span>(), <span class="ident">t</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_hms" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#568-570" title="goto source code">[src]</a></div><a href="#method.and_hms" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_hms" class="fnname">and_hms</a>(&self, hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></div></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>
|
||
<p>Panics on invalid hour, minute and/or second.</p>
|
||
<h5 id="example-11" class="section-header"><a href="#example-11">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
|
||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Wed</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_hms_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#591-593" title="goto source code">[src]</a></div><a href="#method.and_hms_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_hms_opt" class="fnname">and_hms_opt</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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>
|
||
<p>Returns <code>None</code> on invalid hour, minute and/or second.</p>
|
||
<h5 id="example-12" class="section-header"><a href="#example-12">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).<span class="ident">is_some</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>).<span class="ident">is_none</span>()); <span class="comment">// use `and_hms_milli_opt` instead</span>
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_opt</span>(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_opt</span>(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>).<span class="ident">is_none</span>());</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_hms_milli" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#616-618" title="goto source code">[src]</a></div><a href="#method.and_hms_milli" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_hms_milli" class="fnname">and_hms_milli</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> milli: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a><br>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></div></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 can exceed 1,000
|
||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||
<p>Panics on invalid hour, minute, second and/or millisecond.</p>
|
||
<h5 id="example-13" class="section-header"><a href="#example-13">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
|
||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Wed</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">nanosecond</span>(), <span class="number">789_000_000</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_hms_milli_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#641-649" title="goto source code">[src]</a></div><a href="#method.and_hms_milli_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_hms_milli_opt" class="fnname">and_hms_milli_opt</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> milli: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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 can exceed 1,000
|
||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||
<p>Returns <code>None</code> on invalid hour, minute, second and/or millisecond.</p>
|
||
<h5 id="example-14" class="section-header"><a href="#example-14">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).<span class="ident">is_some</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789</span>).<span class="ident">is_some</span>()); <span class="comment">// leap second</span>
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).<span class="ident">is_none</span>());</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_hms_micro" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#672-674" title="goto source code">[src]</a></div><a href="#method.and_hms_micro" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_hms_micro" class="fnname">and_hms_micro</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> micro: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a><br>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></div></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 can exceed 1,000,000
|
||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||
<p>Panics on invalid hour, minute, second and/or microsecond.</p>
|
||
<h5 id="example-15" class="section-header"><a href="#example-15">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
|
||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_hms_micro</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Wed</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">nanosecond</span>(), <span class="number">789_012_000</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_hms_micro_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#697-705" title="goto source code">[src]</a></div><a href="#method.and_hms_micro_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_hms_micro_opt" class="fnname">and_hms_micro_opt</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> micro: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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 can exceed 1,000,000
|
||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||
<p>Returns <code>None</code> on invalid hour, minute, second and/or microsecond.</p>
|
||
<h5 id="example-16" class="section-header"><a href="#example-16">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>).<span class="ident">is_some</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789_012</span>).<span class="ident">is_some</span>()); <span class="comment">// leap second</span>
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789_012</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789_012</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789_012</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>).<span class="ident">is_none</span>());</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_hms_nano" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#728-730" title="goto source code">[src]</a></div><a href="#method.and_hms_nano" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_hms_nano" class="fnname">and_hms_nano</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> nano: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a><br>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></div></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 can exceed 1,000,000,000
|
||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||
<p>Panics on invalid hour, minute, second and/or nanosecond.</p>
|
||
<h5 id="example-17" class="section-header"><a href="#example-17">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
|
||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_hms_nano</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012_345</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Wed</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">nanosecond</span>(), <span class="number">789_012_345</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.and_hms_nano_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#753-761" title="goto source code">[src]</a></div><a href="#method.and_hms_nano_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.and_hms_nano_opt" class="fnname">and_hms_nano_opt</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>, <br> nano: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></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 can exceed 1,000,000,000
|
||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||
<p>Returns <code>None</code> on invalid hour, minute, second and/or nanosecond.</p>
|
||
<h5 id="example-18" class="section-header"><a href="#example-18">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).<span class="ident">is_some</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789_012_345</span>).<span class="ident">is_some</span>()); <span class="comment">// leap second</span>
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789_012_345</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789_012_345</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).<span class="ident">is_none</span>());</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.succ" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#810-812" title="goto source code">[src]</a></div><a href="#method.succ" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.succ" class="fnname">succ</a>(&self) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the next calendar date.</p>
|
||
<p>Panics when <code>self</code> is the last representable date.</p>
|
||
<h5 id="example-19" class="section-header"><a href="#example-19">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).<span class="ident">succ</span>(), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">4</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">succ</span>(), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">succ</span>(), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>));</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.succ_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#829-831" title="goto source code">[src]</a></div><a href="#method.succ_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.succ_opt" class="fnname">succ_opt</a>(&self) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the next calendar date.</p>
|
||
<p>Returns <code>None</code> when <code>self</code> is the last representable date.</p>
|
||
<h5 id="example-20" class="section-header"><a href="#example-20">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
<span class="kw">use</span> <span class="ident">chrono::naive::MAX_DATE</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).<span class="ident">succ_opt</span>(),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">4</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">MAX_DATE</span>.<span class="ident">succ_opt</span>(), <span class="prelude-val">None</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.pred" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#847-849" title="goto source code">[src]</a></div><a href="#method.pred" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.pred" class="fnname">pred</a>(&self) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the previous calendar date.</p>
|
||
<p>Panics when <code>self</code> is the first representable date.</p>
|
||
<h5 id="example-21" class="section-header"><a href="#example-21">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).<span class="ident">pred</span>(), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">2</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">1</span>).<span class="ident">pred</span>(), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">5</span>, <span class="number">31</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">pred</span>(), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">31</span>));</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.pred_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#866-868" title="goto source code">[src]</a></div><a href="#method.pred_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.pred_opt" class="fnname">pred_opt</a>(&self) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the previous calendar date.</p>
|
||
<p>Returns <code>None</code> when <code>self</code> is the first representable date.</p>
|
||
<h5 id="example-22" class="section-header"><a href="#example-22">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
<span class="kw">use</span> <span class="ident">chrono::naive::MIN_DATE</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).<span class="ident">pred_opt</span>(),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">2</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">MIN_DATE</span>.<span class="ident">pred_opt</span>(), <span class="prelude-val">None</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.checked_add_signed" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#891-902" title="goto source code">[src]</a></div><a href="#method.checked_add_signed" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.checked_add_signed" class="fnname">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.59.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></div></summary><div class="docblock"><p>Adds the <code>days</code> part of given <code>Duration</code> to the current date.</p>
|
||
<p>Returns <code>None</code> when it will result in overflow.</p>
|
||
<h5 id="example-23" class="section-header"><a href="#example-23">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||
<span class="kw">use</span> <span class="ident">chrono::naive::MAX_DATE</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::days</span>(<span class="number">40</span>)),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">15</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::days</span>(<span class="op">-</span><span class="number">40</span>)),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">27</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::days</span>(<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::days</span>(<span class="op">-</span><span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">MAX_DATE</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::days</span>(<span class="number">1</span>)), <span class="prelude-val">None</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.checked_sub_signed" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#925-936" title="goto source code">[src]</a></div><a href="#method.checked_sub_signed" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.checked_sub_signed" class="fnname">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.59.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></div></summary><div class="docblock"><p>Subtracts the <code>days</code> part of given <code>Duration</code> from the current date.</p>
|
||
<p>Returns <code>None</code> when it will result in overflow.</p>
|
||
<h5 id="example-24" class="section-header"><a href="#example-24">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||
<span class="kw">use</span> <span class="ident">chrono::naive::MIN_DATE</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::days</span>(<span class="number">40</span>)),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">27</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::days</span>(<span class="op">-</span><span class="number">40</span>)),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">15</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::days</span>(<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::days</span>(<span class="op">-</span><span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">MIN_DATE</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::days</span>(<span class="number">1</span>)), <span class="prelude-val">None</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.signed_duration_since" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#962-972" title="goto source code">[src]</a></div><a href="#method.signed_duration_since" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.signed_duration_since" class="fnname">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></div></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-25" class="section-header"><a href="#example-25">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>;
|
||
<span class="kw">let</span> <span class="ident">since</span> <span class="op">=</span> <span class="ident">NaiveDate::signed_duration_since</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="ident">Duration::zero</span>());
|
||
<span class="macro">assert_eq!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>)), <span class="ident">Duration::days</span>(<span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>)), <span class="ident">Duration::days</span>(<span class="op">-</span><span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">9</span>, <span class="number">23</span>)), <span class="ident">Duration::days</span>(<span class="number">100</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="ident">Duration::days</span>(<span class="number">365</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="ident">Duration::days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">4</span> <span class="op">+</span> <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">1614</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="ident">Duration::days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">400</span> <span class="op">+</span> <span class="number">97</span>));</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.format_with_items" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1003-1009" title="goto source code">[src]</a></div><a href="#method.format_with_items" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.format_with_items" class="fnname">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<br> I: <a class="trait" href="https://doc.rust-lang.org/1.59.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.59.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,<br> B: <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></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-26" class="section-header"><a href="#example-26">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
<span class="kw">use</span> <span class="ident">chrono::format::strftime::StrftimeItems</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">fmt</span> <span class="op">=</span> <span class="ident">StrftimeItems::new</span>(<span class="string">"%Y-%m-%d"</span>);
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>.<span class="ident">clone</span>()).<span class="ident">to_string</span>(), <span class="string">"2015-09-05"</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%Y-%m-%d"</span>).<span class="ident">to_string</span>(), <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>, <span class="ident">d</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>)), <span class="string">"2015-09-05"</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.format" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1045-1047" title="goto source code">[src]</a></div><a href="#method.format" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.format" class="fnname">format</a><'a>(&self, fmt: &'a <a class="primitive" href="https://doc.rust-lang.org/1.59.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></div></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-27" class="section-header"><a href="#example-27">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%Y-%m-%d"</span>).<span class="ident">to_string</span>(), <span class="string">"2015-09-05"</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%A, %-d %B, %C%y"</span>).<span class="ident">to_string</span>(), <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>, <span class="ident">d</span>.<span class="ident">format</span>(<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>, <span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%A, %-d %B, %C%y"</span>)), <span class="string">"Saturday, 5 September, 2015"</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.iter_days" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1071-1073" title="goto source code">[src]</a></div><a href="#method.iter_days" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.iter_days" class="fnname">iter_days</a>(&self) -> NaiveDateDaysIterator</h4></div></summary><div class="docblock"><p>Returns an iterator that steps by days until the last representable date.</p>
|
||
<h5 id="example-28" class="section-header"><a href="#example-28">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code>
|
||
<span class="kw">let</span> <span class="ident">expected</span> <span class="op">=</span> [
|
||
<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>),
|
||
<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">28</span>),
|
||
<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>),
|
||
<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">1</span>),
|
||
];
|
||
|
||
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">count</span> <span class="op">=</span> <span class="number">0</span>;
|
||
<span class="kw">for</span> (<span class="ident">idx</span>, <span class="ident">d</span>) <span class="kw">in</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>).<span class="ident">iter_days</span>().<span class="ident">take</span>(<span class="number">4</span>).<span class="ident">enumerate</span>() {
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>, <span class="ident">expected</span>[<span class="ident">idx</span>]);
|
||
<span class="ident">count</span> <span class="op">+</span><span class="op">=</span> <span class="number">1</span>;
|
||
}
|
||
<span class="macro">assert_eq!</span>(<span class="ident">count</span>, <span class="number">4</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.iter_weeks" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1097-1099" title="goto source code">[src]</a></div><a href="#method.iter_weeks" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.iter_weeks" class="fnname">iter_weeks</a>(&self) -> NaiveDateWeeksIterator</h4></div></summary><div class="docblock"><p>Returns an iterator that steps by weeks until the last representable date.</p>
|
||
<h5 id="example-29" class="section-header"><a href="#example-29">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code>
|
||
<span class="kw">let</span> <span class="ident">expected</span> <span class="op">=</span> [
|
||
<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>),
|
||
<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">5</span>),
|
||
<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">12</span>),
|
||
<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">19</span>),
|
||
];
|
||
|
||
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">count</span> <span class="op">=</span> <span class="number">0</span>;
|
||
<span class="kw">for</span> (<span class="ident">idx</span>, <span class="ident">d</span>) <span class="kw">in</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>).<span class="ident">iter_weeks</span>().<span class="ident">take</span>(<span class="number">4</span>).<span class="ident">enumerate</span>() {
|
||
<span class="macro">assert_eq!</span>(<span class="ident">d</span>, <span class="ident">expected</span>[<span class="ident">idx</span>]);
|
||
<span class="ident">count</span> <span class="op">+</span><span class="op">=</span> <span class="number">1</span>;
|
||
}
|
||
<span class="macro">assert_eq!</span>(<span class="ident">count</span>, <span class="number">4</span>);</code></pre></div>
|
||
</div></details></div></details><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Add%3CDuration%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1468-1475" title="goto source code">[src]</a></div><a href="#impl-Add%3CDuration%3E" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></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="#method.checked_add_signed"><code>NaiveDate::checked_add_signed</code></a> to detect that.</p>
|
||
<h4 id="example-49" class="section-header"><a href="#example-49">Example</a></h4>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration::zero</span>(), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration::seconds</span>(<span class="number">86399</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration::seconds</span>(<span class="op">-</span><span class="number">86399</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration::days</span>(<span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration::days</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration::days</span>(<span class="number">364</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">31</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration::days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">4</span> <span class="op">+</span> <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration::days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">400</span> <span class="op">+</span> <span class="number">97</span>), <span class="ident">from_ymd</span>(<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="rustdoc-toggle" open><summary><div id="associatedtype.Output-2" class="type trait-impl has-srclink"><a href="#associatedtype.Output-2" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.59.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></div></summary><div class='docblock'><p>The resulting type after applying the <code>+</code> operator.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.add" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1472-1474" title="goto source code">[src]</a></div><a href="#method.add" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.Add.html#tymethod.add" class="fnname">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></div></summary><div class='docblock'><p>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-AddAssign%3CDuration%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1477-1482" title="goto source code">[src]</a></div><a href="#impl-AddAssign%3CDuration%3E" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.add_assign" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1479-1481" title="goto source code">[src]</a></div><a href="#method.add_assign" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.AddAssign.html#tymethod.add_assign" class="fnname">add_assign</a>(&mut self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</h4></div></summary><div class='docblock'><p>Performs the <code>+=</code> operation. <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.AddAssign.html#tymethod.add_assign">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Clone" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-Clone" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.clone" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#method.clone" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/clone/trait.Clone.html#tymethod.clone" class="fnname">clone</a>(&self) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></div></summary><div class='docblock'><p>Returns a copy of the value. <a href="https://doc.rust-lang.org/1.59.0/core/clone/trait.Clone.html#tymethod.clone">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.clone_from" class="method trait-impl has-srclink"><div 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.59.0/src/core/clone.rs.html#130" title="goto source code">[src]</a></div><a href="#method.clone_from" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/clone/trait.Clone.html#method.clone_from" class="fnname">clone_from</a>(&mut self, source: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&</a>Self)</h4></div></summary><div class='docblock'><p>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/1.59.0/core/clone/trait.Clone.html#method.clone_from">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Datelike" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1102-1442" title="goto source code">[src]</a></div><a href="#impl-Datelike" class="anchor"></a><h3 class="code-header in-band">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></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.year" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1114-1116" title="goto source code">[src]</a></div><a href="#method.year" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.year" class="fnname">year</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a></h4></div></summary><div class="docblock"><p>Returns the year number in the <a href="#calendar-date">calendar date</a>.</p>
|
||
<h5 id="example-30" class="section-header"><a href="#example-30">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">year</span>(), <span class="number">2015</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">year</span>(), <span class="op">-</span><span class="number">308</span>); <span class="comment">// 309 BCE</span></code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.month" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1131-1133" title="goto source code">[src]</a></div><a href="#method.month" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.month" class="fnname">month</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a></h4></div></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-31" class="section-header"><a href="#example-31">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">month</span>(), <span class="number">9</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">month</span>(), <span class="number">3</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.month0" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1148-1150" title="goto source code">[src]</a></div><a href="#method.month0" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.month0" class="fnname">month0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a></h4></div></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-32" class="section-header"><a href="#example-32">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">month0</span>(), <span class="number">8</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">month0</span>(), <span class="number">2</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.day" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1188-1190" title="goto source code">[src]</a></div><a href="#method.day" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.day" class="fnname">day</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a></h4></div></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-33" class="section-header"><a href="#example-33">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">day</span>(), <span class="number">8</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">day</span>(), <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> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="kw">fn</span> <span class="ident">ndays_in_month</span>(<span class="ident">year</span>: <span class="ident">i32</span>, <span class="ident">month</span>: <span class="ident">u32</span>) -> <span class="ident">u32</span> {
|
||
<span class="comment">// the first day of the next month...</span>
|
||
<span class="kw">let</span> (<span class="ident">y</span>, <span class="ident">m</span>) <span class="op">=</span> <span class="kw">if</span> <span class="ident">month</span> <span class="op">==</span> <span class="number">12</span> { (<span class="ident">year</span> <span class="op">+</span> <span class="number">1</span>, <span class="number">1</span>) } <span class="kw">else</span> { (<span class="ident">year</span>, <span class="ident">month</span> <span class="op">+</span> <span class="number">1</span>) };
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="ident">y</span>, <span class="ident">m</span>, <span class="number">1</span>);
|
||
|
||
<span class="comment">// ...is preceded by the last day of the original month</span>
|
||
<span class="ident">d</span>.<span class="ident">pred</span>().<span class="ident">day</span>()
|
||
}
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2015</span>, <span class="number">8</span>), <span class="number">31</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2015</span>, <span class="number">9</span>), <span class="number">30</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2015</span>, <span class="number">12</span>), <span class="number">31</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2016</span>, <span class="number">2</span>), <span class="number">29</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2017</span>, <span class="number">2</span>), <span class="number">28</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.day0" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1205-1207" title="goto source code">[src]</a></div><a href="#method.day0" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.day0" class="fnname">day0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a></h4></div></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-34" class="section-header"><a href="#example-34">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">day0</span>(), <span class="number">7</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">day0</span>(), <span class="number">13</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.ordinal" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1244-1246" title="goto source code">[src]</a></div><a href="#method.ordinal" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.ordinal" class="fnname">ordinal</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a></h4></div></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-35" class="section-header"><a href="#example-35">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">ordinal</span>(), <span class="number">251</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">ordinal</span>(), <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> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="kw">fn</span> <span class="ident">ndays_in_year</span>(<span class="ident">year</span>: <span class="ident">i32</span>) -> <span class="ident">u32</span> {
|
||
<span class="comment">// the first day of the next year...</span>
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="ident">year</span> <span class="op">+</span> <span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>);
|
||
|
||
<span class="comment">// ...is preceded by the last day of the original year</span>
|
||
<span class="ident">d</span>.<span class="ident">pred</span>().<span class="ident">ordinal</span>()
|
||
}
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2015</span>), <span class="number">365</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2016</span>), <span class="number">366</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2017</span>), <span class="number">365</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2000</span>), <span class="number">366</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2100</span>), <span class="number">365</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.ordinal0" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1261-1263" title="goto source code">[src]</a></div><a href="#method.ordinal0" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.ordinal0" class="fnname">ordinal0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a></h4></div></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-36" class="section-header"><a href="#example-36">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">ordinal0</span>(), <span class="number">250</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">ordinal0</span>(), <span class="number">73</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.weekday" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1276-1278" title="goto source code">[src]</a></div><a href="#method.weekday" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.weekday" class="fnname">weekday</a>(&self) -> <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a></h4></div></summary><div class="docblock"><p>Returns the day of week.</p>
|
||
<h5 id="example-37" class="section-header"><a href="#example-37">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">weekday</span>(), <span class="ident">Weekday::Tue</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">weekday</span>(), <span class="ident">Weekday::Fri</span>);</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.with_year" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1308-1317" title="goto source code">[src]</a></div><a href="#method.with_year" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_year" class="fnname">with_year</a>(&self, year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the year number changed.</p>
|
||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||
<h5 id="example-38" class="section-header"><a href="#example-38">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_year</span>(<span class="number">2016</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">8</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_year</span>(<span class="op">-</span><span class="number">308</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">9</span>, <span class="number">8</span>)));</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>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">with_year</span>(<span class="number">2015</span>).<span class="ident">is_none</span>());
|
||
<span class="macro">assert!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">with_year</span>(<span class="number">2020</span>).<span class="ident">is_some</span>());</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.with_month" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1334-1336" title="goto source code">[src]</a></div><a href="#method.with_month" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_month" class="fnname">with_month</a>(&self, month: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the month number (starting from 1) changed.</p>
|
||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||
<h5 id="example-39" class="section-header"><a href="#example-39">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_month</span>(<span class="number">10</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">8</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_month</span>(<span class="number">13</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).<span class="ident">with_month</span>(<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="rustdoc-toggle method-toggle" open><summary><div id="method.with_month0" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1353-1355" title="goto source code">[src]</a></div><a href="#method.with_month0" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_month0" class="fnname">with_month0</a>(&self, month0: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the month number (starting from 0) changed.</p>
|
||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||
<h5 id="example-40" class="section-header"><a href="#example-40">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_month0</span>(<span class="number">9</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">8</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_month0</span>(<span class="number">12</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13</span>
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).<span class="ident">with_month0</span>(<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="rustdoc-toggle method-toggle" open><summary><div id="method.with_day" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1372-1374" title="goto source code">[src]</a></div><a href="#method.with_day" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_day" class="fnname">with_day</a>(&self, day: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of month (starting from 1) changed.</p>
|
||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||
<h5 id="example-41" class="section-header"><a href="#example-41">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_day</span>(<span class="number">30</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_day</span>(<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="rustdoc-toggle method-toggle" open><summary><div id="method.with_day0" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1391-1393" title="goto source code">[src]</a></div><a href="#method.with_day0" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_day0" class="fnname">with_day0</a>(&self, day0: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of month (starting from 0) changed.</p>
|
||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||
<h5 id="example-42" class="section-header"><a href="#example-42">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_day0</span>(<span class="number">29</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_day0</span>(<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="rustdoc-toggle method-toggle" open><summary><div id="method.with_ordinal" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1415-1417" title="goto source code">[src]</a></div><a href="#method.with_ordinal" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_ordinal" class="fnname">with_ordinal</a>(&self, ordinal: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of year (starting from 1) changed.</p>
|
||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||
<h5 id="example-43" class="section-header"><a href="#example-43">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal</span>(<span class="number">60</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal</span>(<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>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal</span>(<span class="number">60</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal</span>(<span class="number">366</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>)));</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.with_ordinal0" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1439-1441" title="goto source code">[src]</a></div><a href="#method.with_ordinal0" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_ordinal0" class="fnname">with_ordinal0</a>(&self, ordinal0: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of year (starting from 0) changed.</p>
|
||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||
<h5 id="example-44" class="section-header"><a href="#example-44">Example</a></h5>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal0</span>(<span class="number">59</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal0</span>(<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>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal0</span>(<span class="number">59</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>)));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal0</span>(<span class="number">365</span>),
|
||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>)));</code></pre></div>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.iso_week" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1281-1283" title="goto source code">[src]</a></div><a href="#method.iso_week" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.iso_week" class="fnname">iso_week</a>(&self) -> <a class="struct" href="struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></h4></div></summary><div class='docblock'><p>Returns the ISO week.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.year_ce" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/lib.rs.html#1252-1259" title="goto source code">[src]</a></div><a href="#method.year_ce" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Datelike.html#method.year_ce" class="fnname">year_ce</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.bool.html">bool</a>, <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a><a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.tuple.html">)</a></h4></div></summary><div class='docblock'><p>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). <a href="../trait.Datelike.html#method.year_ce">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.num_days_from_ce" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/lib.rs.html#1344-1359" title="goto source code">[src]</a></div><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="fnname">num_days_from_ce</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a></h4></div></summary><div class='docblock'><p>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></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Debug" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1639-1650" title="goto source code">[src]</a></div><a href="#impl-Debug" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></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-50" class="section-header"><a href="#example-50">Example</a></h4>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>)), <span class="string">"2015-09-05"</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate::from_ymd</span>( <span class="number">0</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="string">"0000-01-01"</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate::from_ymd</span>(<span class="number">9999</span>, <span class="number">12</span>, <span class="number">31</span>)), <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>, <span class="ident">NaiveDate::from_ymd</span>( <span class="op">-</span><span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="string">"-0001-01-01"</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate::from_ymd</span>(<span class="number">10000</span>, <span class="number">12</span>, <span class="number">31</span>)), <span class="string">"+10000-12-31"</span>);</code></pre></div>
|
||
</div><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.fmt-1" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1640-1649" title="goto source code">[src]</a></div><a href="#method.fmt-1" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/fmt/trait.Debug.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/1.59.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/1.59.0/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></div></summary><div class='docblock'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.59.0/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Display" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1674-1678" title="goto source code">[src]</a></div><a href="#impl-Display" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></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-47" class="section-header"><a href="#example-47">Example</a></h4>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>)), <span class="string">"2015-09-05"</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate::from_ymd</span>( <span class="number">0</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="string">"0000-01-01"</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate::from_ymd</span>(<span class="number">9999</span>, <span class="number">12</span>, <span class="number">31</span>)), <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>, <span class="ident">NaiveDate::from_ymd</span>( <span class="op">-</span><span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="string">"-0001-01-01"</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate::from_ymd</span>(<span class="number">10000</span>, <span class="number">12</span>, <span class="number">31</span>)), <span class="string">"+10000-12-31"</span>);</code></pre></div>
|
||
</div><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.fmt" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1675-1677" title="goto source code">[src]</a></div><a href="#method.fmt" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/fmt/trait.Display.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/1.59.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/1.59.0/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></div></summary><div class='docblock'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.59.0/core/fmt/trait.Display.html#tymethod.fmt">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-FromStr" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1696-1715" title="goto source code">[src]</a></div><a href="#impl-FromStr" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></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-48" class="section-header"><a href="#example-48">Example</a></h4>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono::NaiveDate</span>;
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">18</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="string">"2015-09-18"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDate</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">d</span>));
|
||
|
||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">12345</span>, <span class="number">6</span>, <span class="number">7</span>);
|
||
<span class="macro">assert_eq!</span>(<span class="string">"+12345-6-7"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDate</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">d</span>));
|
||
|
||
<span class="macro">assert!</span>(<span class="string">"foo"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDate</span><span class="op">></span>().<span class="ident">is_err</span>());</code></pre></div>
|
||
</div><div class="impl-items"><details class="rustdoc-toggle" open><summary><div id="associatedtype.Err" class="type trait-impl has-srclink"><a href="#associatedtype.Err" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.59.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></div></summary><div class='docblock'><p>The associated error which can be returned from parsing.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_str" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1699-1714" title="goto source code">[src]</a></div><a href="#method.from_str" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/str/traits/trait.FromStr.html#tymethod.from_str" class="fnname">from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/1.59.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></div></summary><div class='docblock'><p>Parses a string <code>s</code> to return a value of this type. <a href="https://doc.rust-lang.org/1.59.0/core/str/traits/trait.FromStr.html#tymethod.from_str">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Hash" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-Hash" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.hash" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#method.hash" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/hash/trait.Hash.html#tymethod.hash" class="fnname">hash</a><__H: <a class="trait" href="https://doc.rust-lang.org/1.59.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.59.0/std/primitive.reference.html">&mut </a>__H)</h4></div></summary><div class='docblock'><p>Feeds this value into the given <a href="https://doc.rust-lang.org/1.59.0/core/hash/trait.Hasher.html" title="Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/1.59.0/core/hash/trait.Hash.html#tymethod.hash">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.hash_slice" class="method trait-impl has-srclink"><div 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.59.0/src/core/hash/mod.rs.html#237-239" title="goto source code">[src]</a></div><a href="#method.hash_slice" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/hash/trait.Hash.html#method.hash_slice" class="fnname">hash_slice</a><H>(data: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.slice.html">&[Self]</a>, state: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&mut </a>H) <span class="where fmt-newline">where<br> H: <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>, </span></h4></div></summary><div class='docblock'><p>Feeds a slice of this type into the given <a href="https://doc.rust-lang.org/1.59.0/core/hash/trait.Hasher.html" title="Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/1.59.0/core/hash/trait.Hash.html#method.hash_slice">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Ord" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-Ord" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.cmp" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#method.cmp" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.Ord.html#tymethod.cmp" class="fnname">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.59.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a></h4></div></summary><div class='docblock'><p>This method returns an <a href="https://doc.rust-lang.org/1.59.0/core/cmp/enum.Ordering.html" title="Ordering"><code>Ordering</code></a> between <code>self</code> and <code>other</code>. <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.Ord.html#tymethod.cmp">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.max" class="method trait-impl has-srclink"><div 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.59.0/src/core/cmp.rs.html#768-770" title="goto source code">[src]</a></div><a href="#method.max" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.Ord.html#method.max" class="fnname">max</a>(self, other: Self) -> Self</h4></div></summary><div class='docblock'><p>Compares and returns the maximum of two values. <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.Ord.html#method.max">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.min" class="method trait-impl has-srclink"><div 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.59.0/src/core/cmp.rs.html#788-790" title="goto source code">[src]</a></div><a href="#method.min" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.Ord.html#method.min" class="fnname">min</a>(self, other: Self) -> Self</h4></div></summary><div class='docblock'><p>Compares and returns the minimum of two values. <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.Ord.html#method.min">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.clamp" class="method trait-impl has-srclink"><div 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.59.0/src/core/cmp.rs.html#813-815" title="goto source code">[src]</a></div><a href="#method.clamp" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.Ord.html#method.clamp" class="fnname">clamp</a>(self, min: Self, max: Self) -> Self</h4></div></summary><div class='docblock'><p>Restrict a value to a certain interval. <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.Ord.html#method.clamp">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-PartialEq%3CNaiveDate%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-PartialEq%3CNaiveDate%3E" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.eq" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#method.eq" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.PartialEq.html#tymethod.eq" class="fnname">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.59.0/std/primitive.bool.html">bool</a></h4></div></summary><div class='docblock'><p>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
|
||
by <code>==</code>. <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.PartialEq.html#tymethod.eq">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.ne" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#method.ne" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.PartialEq.html#method.ne" class="fnname">ne</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.59.0/std/primitive.bool.html">bool</a></h4></div></summary><div class='docblock'><p>This method tests for <code>!=</code>.</p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-PartialOrd%3CNaiveDate%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-PartialOrd%3CNaiveDate%3E" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.partial_cmp" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#method.partial_cmp" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp" class="fnname">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.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="enum" href="https://doc.rust-lang.org/1.59.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a>></h4></div></summary><div class='docblock'><p>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.59.0/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.lt" class="method trait-impl has-srclink"><div 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.59.0/src/core/cmp.rs.html#1036" title="goto source code">[src]</a></div><a href="#method.lt" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.PartialOrd.html#method.lt" class="fnname">lt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.bool.html">bool</a></h4></div></summary><div class='docblock'><p>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.59.0/core/cmp/trait.PartialOrd.html#method.lt">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.le" class="method trait-impl has-srclink"><div 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.59.0/src/core/cmp.rs.html#1056" title="goto source code">[src]</a></div><a href="#method.le" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.PartialOrd.html#method.le" class="fnname">le</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.bool.html">bool</a></h4></div></summary><div class='docblock'><p>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.59.0/core/cmp/trait.PartialOrd.html#method.le">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.gt" class="method trait-impl has-srclink"><div 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.59.0/src/core/cmp.rs.html#1079" title="goto source code">[src]</a></div><a href="#method.gt" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.PartialOrd.html#method.gt" class="fnname">gt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.bool.html">bool</a></h4></div></summary><div class='docblock'><p>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.59.0/core/cmp/trait.PartialOrd.html#method.gt">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.ge" class="method trait-impl has-srclink"><div 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.59.0/src/core/cmp.rs.html#1099" title="goto source code">[src]</a></div><a href="#method.ge" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/cmp/trait.PartialOrd.html#method.ge" class="fnname">ge</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.bool.html">bool</a></h4></div></summary><div class='docblock'><p>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.59.0/core/cmp/trait.PartialOrd.html#method.ge">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Sub%3CDuration%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1509-1516" title="goto source code">[src]</a></div><a href="#impl-Sub%3CDuration%3E" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></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="#method.checked_sub_signed"><code>NaiveDate::checked_sub_signed</code></a> to detect that.</p>
|
||
<h4 id="example-45" class="section-header"><a href="#example-45">Example</a></h4>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration::zero</span>(), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration::seconds</span>(<span class="number">86399</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration::seconds</span>(<span class="op">-</span><span class="number">86399</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration::days</span>(<span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration::days</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration::days</span>(<span class="number">364</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">2</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration::days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">4</span> <span class="op">+</span> <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration::days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">400</span> <span class="op">+</span> <span class="number">97</span>), <span class="ident">from_ymd</span>(<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="rustdoc-toggle" open><summary><div id="associatedtype.Output" class="type trait-impl has-srclink"><a href="#associatedtype.Output" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.59.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></div></summary><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.sub" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1513-1515" title="goto source code">[src]</a></div><a href="#method.sub" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">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></div></summary><div class='docblock'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Sub%3CNaiveDate%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1551-1558" title="goto source code">[src]</a></div><a href="#impl-Sub%3CNaiveDate%3E" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></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-46" class="section-header"><a href="#example-46">Example</a></h4>
|
||
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||
|
||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>;
|
||
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">Duration::zero</span>());
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>), <span class="ident">Duration::days</span>(<span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>), <span class="ident">Duration::days</span>(<span class="op">-</span><span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">9</span>, <span class="number">23</span>), <span class="ident">Duration::days</span>(<span class="number">100</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">Duration::days</span>(<span class="number">365</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">Duration::days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">4</span> <span class="op">+</span> <span class="number">1</span>));
|
||
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">1614</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">Duration::days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">400</span> <span class="op">+</span> <span class="number">97</span>));</code></pre></div>
|
||
</div><div class="impl-items"><details class="rustdoc-toggle" open><summary><div id="associatedtype.Output-1" class="type trait-impl has-srclink"><a href="#associatedtype.Output-1" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a></h4></div></summary><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.sub-1" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1555-1557" title="goto source code">[src]</a></div><a href="#method.sub-1" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">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></div></summary><div class='docblock'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-SubAssign%3CDuration%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1518-1523" title="goto source code">[src]</a></div><a href="#impl-SubAssign%3CDuration%3E" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.sub_assign" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#1520-1522" title="goto source code">[src]</a></div><a href="#method.sub_assign" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign" class="fnname">sub_assign</a>(&mut self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</h4></div></summary><div class='docblock'><p>Performs the <code>-=</code> operation. <a href="https://doc.rust-lang.org/1.59.0/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign">Read more</a></p>
|
||
</div></details></div></details><div id="impl-Copy" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-Copy" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div><div id="impl-Eq" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-Eq" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div><div id="impl-StructuralEq" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-StructuralEq" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div><div id="impl-StructuralPartialEq" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></div><a href="#impl-StructuralPartialEq" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></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"><div id="impl-RefUnwindSafe" class="impl has-srclink"><div class="rightside"></div><a href="#impl-RefUnwindSafe" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div><div id="impl-Send" class="impl has-srclink"><div class="rightside"></div><a href="#impl-Send" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div><div id="impl-Sync" class="impl has-srclink"><div class="rightside"></div><a href="#impl-Sync" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div><div id="impl-Unpin" class="impl has-srclink"><div class="rightside"></div><a href="#impl-Unpin" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div><div id="impl-UnwindSafe" class="impl has-srclink"><div class="rightside"></div><a href="#impl-UnwindSafe" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="https://doc.rust-lang.org/1.59.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></div></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Any" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/any.rs.html#132-136" title="goto source code">[src]</a></div><a href="#impl-Any" class="anchor"></a><h3 class="code-header in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T <span class="where fmt-newline">where<br> T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/1.59.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.type_id" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/any.rs.html#133" title="goto source code">[src]</a></div><a href="#method.type_id" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/core/any/trait.Any.html#tymethod.type_id" class="fnname">type_id</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/1.59.0/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></h4></div></summary><div class='docblock'><p>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/1.59.0/core/any/trait.Any.html#tymethod.type_id">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Borrow%3CT%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/borrow.rs.html#209-214" title="goto source code">[src]</a></div><a href="#impl-Borrow%3CT%3E" class="anchor"></a><h3 class="code-header in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/1.59.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.borrow" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/borrow.rs.html#211" title="goto source code">[src]</a></div><a href="#method.borrow" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/core/borrow/trait.Borrow.html#tymethod.borrow" class="fnname">borrow</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&</a>T</h4></div></summary><div class='docblock'><p>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.59.0/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-BorrowMut%3CT%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/borrow.rs.html#218-222" title="goto source code">[src]</a></div><a href="#impl-BorrowMut%3CT%3E" class="anchor"></a><h3 class="code-header in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/1.59.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.borrow_mut" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/borrow.rs.html#219" title="goto source code">[src]</a></div><a href="#method.borrow_mut" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fnname">borrow_mut</a>(&mut self) -> <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&mut </a>T</h4></div></summary><div class='docblock'><p>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.59.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-From%3CT%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/convert/mod.rs.html#550-554" title="goto source code">[src]</a></div><a href="#impl-From%3CT%3E" class="anchor"></a><h3 class="code-header in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for T</h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/convert/mod.rs.html#551" title="goto source code">[src]</a></div><a href="#method.from" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/core/convert/trait.From.html#tymethod.from" class="fnname">from</a>(t: T) -> T</h4></div></summary><div class='docblock'><p>Performs the conversion.</p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Into%3CU%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/convert/mod.rs.html#538-545" title="goto source code">[src]</a></div><a href="#impl-Into%3CU%3E" class="anchor"></a><h3 class="code-header in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T>, </span></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.into" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/convert/mod.rs.html#542" title="goto source code">[src]</a></div><a href="#method.into" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/core/convert/trait.Into.html#tymethod.into" class="fnname">into</a>(self) -> U</h4></div></summary><div class='docblock'><p>Performs the conversion.</p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-ToOwned" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/alloc/borrow.rs.html#84-96" title="goto source code">[src]</a></div><a href="#impl-ToOwned" class="anchor"></a><h3 class="code-header in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.59.0/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>, </span></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><div id="associatedtype.Owned" class="type trait-impl has-srclink"><a href="#associatedtype.Owned" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.59.0/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="associatedtype">Owned</a> = T</h4></div></summary><div class='docblock'><p>The resulting type after obtaining ownership.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.to_owned" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/alloc/borrow.rs.html#89" title="goto source code">[src]</a></div><a href="#method.to_owned" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fnname">to_owned</a>(&self) -> T</h4></div></summary><div class='docblock'><p>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/1.59.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.clone_into" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/alloc/borrow.rs.html#93" title="goto source code">[src]</a></div><a href="#method.clone_into" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fnname">clone_into</a>(&self, target: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&mut </a>T)</h4></div></summary><div class="item-info"><div class="stab unstable"><span class="emoji">🔬</span> This is a nightly-only experimental API. (<code>toowned_clone_into</code>)</div></div><div class='docblock'><p>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/1.59.0/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-ToString" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/alloc/string.rs.html#2388-2402" title="goto source code">[src]</a></div><a href="#impl-ToString" class="anchor"></a><h3 class="code-header in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.59.0/alloc/string/trait.ToString.html" title="trait alloc::string::ToString">ToString</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + ?<a class="trait" href="https://doc.rust-lang.org/1.59.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.to_string" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/alloc/string.rs.html#2394" title="goto source code">[src]</a></div><a href="#method.to_string" class="anchor"></a><h4 class="code-header">pub default fn <a href="https://doc.rust-lang.org/1.59.0/alloc/string/trait.ToString.html#tymethod.to_string" class="fnname">to_string</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/1.59.0/alloc/string/struct.String.html" title="struct alloc::string::String">String</a></h4></div></summary><div class='docblock'><p>Converts the given value to a <code>String</code>. <a href="https://doc.rust-lang.org/1.59.0/alloc/string/trait.ToString.html#tymethod.to_string">Read more</a></p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-TryFrom%3CU%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/convert/mod.rs.html#588-597" title="goto source code">[src]</a></div><a href="#impl-TryFrom%3CU%3E" class="anchor"></a><h3 class="code-header in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><T>, </span></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><div id="associatedtype.Error-1" class="type trait-impl has-srclink"><a href="#associatedtype.Error-1" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html#associatedtype.Error" class="associatedtype">Error</a> = <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></h4></div></summary><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.try_from" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/convert/mod.rs.html#594" title="goto source code">[src]</a></div><a href="#method.try_from" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html#tymethod.try_from" class="fnname">try_from</a>(value: U) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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.59.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></h4></div></summary><div class='docblock'><p>Performs the conversion.</p>
|
||
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-TryInto%3CU%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/convert/mod.rs.html#574-583" title="goto source code">[src]</a></div><a href="#impl-TryInto%3CU%3E" class="anchor"></a><h3 class="code-header in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>, </span></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><div id="associatedtype.Error" class="type trait-impl has-srclink"><a href="#associatedtype.Error" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryInto.html#associatedtype.Error" class="associatedtype">Error</a> = <U as <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></h4></div></summary><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.try_into" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.59.0/src/core/convert/mod.rs.html#580" title="goto source code">[src]</a></div><a href="#method.try_into" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryInto.html#tymethod.try_into" class="fnname">try_into</a>(self) -> <a class="enum" href="https://doc.rust-lang.org/1.59.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.59.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></h4></div></summary><div class='docblock'><p>Performs the conversion.</p>
|
||
</div></details></div></details></div></section><section id="search" class="content hidden"></section></div></main><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono" data-themes="ayu,dark,light" data-resource-suffix="" data-rustdoc-version="1.59.0 (9d1b2106e 2022-02-23)" ></div>
|
||
</body></html> |