evan/ludum-dare-50
Archived
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
This repository has been archived on 2022-04-04. You can view files and clone it, but cannot push or open issues or pull requests.
ludum-dare-50/rustdoc/chrono/naive/struct.NaiveDateTime.html

800 lines
216 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!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 combined date and time without timezone."><meta name="keywords" content="rust, rustlang, rust-lang, NaiveDateTime"><title>NaiveDateTime 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">&#9776;</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 NaiveDateTime</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.checked_add_signed">checked_add_signed</a><a href="#method.checked_sub_signed">checked_sub_signed</a><a href="#method.date">date</a><a href="#method.format">format</a><a href="#method.format_with_items">format_with_items</a><a href="#method.from_timestamp">from_timestamp</a><a href="#method.from_timestamp_opt">from_timestamp_opt</a><a href="#method.new">new</a><a href="#method.parse_from_str">parse_from_str</a><a href="#method.signed_duration_since">signed_duration_since</a><a href="#method.time">time</a><a href="#method.timestamp">timestamp</a><a href="#method.timestamp_millis">timestamp_millis</a><a href="#method.timestamp_nanos">timestamp_nanos</a><a href="#method.timestamp_subsec_micros">timestamp_subsec_micros</a><a href="#method.timestamp_subsec_millis">timestamp_subsec_millis</a><a href="#method.timestamp_subsec_nanos">timestamp_subsec_nanos</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&lt;Duration&gt;</a><a href="#impl-Add%3CFixedOffset%3E">Add&lt;FixedOffset&gt;</a><a href="#impl-AddAssign%3CDuration%3E">AddAssign&lt;Duration&gt;</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%3CNaiveDateTime%3E">PartialEq&lt;NaiveDateTime&gt;</a><a href="#impl-PartialOrd%3CNaiveDateTime%3E">PartialOrd&lt;NaiveDateTime&gt;</a><a href="#impl-StructuralEq">StructuralEq</a><a href="#impl-StructuralPartialEq">StructuralPartialEq</a><a href="#impl-Sub%3CDuration%3E">Sub&lt;Duration&gt;</a><a href="#impl-Sub%3CFixedOffset%3E">Sub&lt;FixedOffset&gt;</a><a href="#impl-Sub%3CNaiveDateTime%3E">Sub&lt;NaiveDateTime&gt;</a><a href="#impl-SubAssign%3CDuration%3E">SubAssign&lt;Duration&gt;</a><a href="#impl-Timelike">Timelike</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&lt;T&gt;</a><a href="#impl-BorrowMut%3CT%3E">BorrowMut&lt;T&gt;</a><a href="#impl-From%3CT%3E">From&lt;T&gt;</a><a href="#impl-Into%3CU%3E">Into&lt;U&gt;</a><a href="#impl-ToOwned">ToOwned</a><a href="#impl-ToString">ToString</a><a href="#impl-TryFrom%3CU%3E">TryFrom&lt;U&gt;</a><a href="#impl-TryInto%3CU%3E">TryInto&lt;U&gt;</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="NaiveDateTime" 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="#">NaiveDateTime</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">&#x2212;</span>]</a></span><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#62-65" title="goto source code">[src]</a></span></h1><div class="docblock item-decl"><pre class="rust struct"><code>pub struct NaiveDateTime { /* 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 combined date and time without timezone.</p>
<h2 id="example" class="section-header"><a href="#example">Example</a></h2>
<p><code>NaiveDateTime</code> is commonly created from <a href="./struct.NaiveDate.html"><code>NaiveDate</code></a>.</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">NaiveDateTime</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>);</code></pre></div>
<p>You can use typical <a href="../trait.Datelike.html">date-like</a> and
<a href="../trait.Timelike.html">time-like</a> methods,
provided that relevant traits are in the scope.</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">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday::Fri</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">num_seconds_from_midnight</span>(), <span class="number">33011</span>);</code></pre></div>
</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/datetime.rs.html#67-700" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.new" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#85-87" title="goto source code">[src]</a></div><a href="#method.new" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.new" class="fnname">new</a>(date: <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>, time: <a class="struct" href="struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -&gt; <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 date and time components.
Equivalent to <a href="./struct.NaiveDate.html#method.and_time"><code>date.and_time(time)</code></a>
and many other helper constructors on <code>NaiveDate</code>.</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</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="op">=</span> <span class="ident">NaiveDateTime::new</span>(<span class="ident">d</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.from_timestamp" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#115-118" title="goto source code">[src]</a></div><a href="#method.from_timestamp" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_timestamp" class="fnname">from_timestamp</a>(secs: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i64.html">i64</a>, nsecs: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <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> corresponding to a UTC date and time,
from the number of non-leap seconds
since the midnight UTC on January 1, 1970 (aka “UNIX timestamp”)
and the number of nanoseconds since the last whole non-leap second.</p>
<p>For a non-naive version of this function see
<a href="../offset/trait.TimeZone.html#method.timestamp"><code>TimeZone::timestamp</code></a>.</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>. (The true “UNIX
timestamp” cannot represent a leap second unambiguously.)</p>
<p>Panics on the out-of-range number of seconds and/or invalid nanosecond.</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">NaiveDateTime</span>, <span class="ident">NaiveDate</span>};
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDateTime::from_timestamp</span>(<span class="number">0</span>, <span class="number">42_000_000</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>, <span class="ident">NaiveDate::from_ymd</span>(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">42</span>));
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDateTime::from_timestamp</span>(<span class="number">1_000_000_000</span>, <span class="number">0</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>, <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>));</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.from_timestamp_opt" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#146-157" title="goto source code">[src]</a></div><a href="#method.from_timestamp_opt" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.from_timestamp_opt" class="fnname">from_timestamp_opt</a>(secs: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i64.html">i64</a>, nsecs: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> corresponding to a UTC date and time,
from the number of non-leap seconds
since the midnight UTC on January 1, 1970 (aka “UNIX timestamp”)
and the number of nanoseconds since the last whole non-leap second.</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>.
(The true “UNIX timestamp” cannot represent a leap second unambiguously.)</p>
<p>Returns <code>None</code> on the out-of-range number of seconds and/or invalid nanosecond.</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</span>::{<span class="ident">NaiveDateTime</span>, <span class="ident">NaiveDate</span>};
<span class="kw">use</span> <span class="ident">std::i64</span>;
<span class="kw">let</span> <span class="ident">from_timestamp_opt</span> <span class="op">=</span> <span class="ident">NaiveDateTime::from_timestamp_opt</span>;
<span class="macro">assert!</span>(<span class="ident">from_timestamp_opt</span>(<span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_some</span>());
<span class="macro">assert!</span>(<span class="ident">from_timestamp_opt</span>(<span class="number">0</span>, <span class="number">999_999_999</span>).<span class="ident">is_some</span>());
<span class="macro">assert!</span>(<span class="ident">from_timestamp_opt</span>(<span class="number">0</span>, <span class="number">1_500_000_000</span>).<span class="ident">is_some</span>()); <span class="comment">// leap second</span>
<span class="macro">assert!</span>(<span class="ident">from_timestamp_opt</span>(<span class="number">0</span>, <span class="number">2_000_000_000</span>).<span class="ident">is_none</span>());
<span class="macro">assert!</span>(<span class="ident">from_timestamp_opt</span>(<span class="ident">i64::MAX</span>, <span class="number">0</span>).<span class="ident">is_none</span>());</code></pre></div>
</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/datetime.rs.html#220-224" 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: &amp;<a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.str.html">str</a>, fmt: &amp;<a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.str.html">str</a>) -&gt; <a class="type" href="../format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Parses a string with the specified format string and returns a new <code>NaiveDateTime</code>.
See the <a href="../format/strftime/index.html"><code>format::strftime</code> module</a>
on the supported escape sequences.</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">NaiveDateTime</span>, <span class="ident">NaiveDate</span>};
<span class="kw">let</span> <span class="ident">parse_from_str</span> <span class="op">=</span> <span class="ident">NaiveDateTime::parse_from_str</span>;
<span class="macro">assert_eq!</span>(<span class="ident">parse_from_str</span>(<span class="string">&quot;2015-09-05 23:56:04&quot;</span>, <span class="string">&quot;%Y-%m-%d %H:%M:%S&quot;</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="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">parse_from_str</span>(<span class="string">&quot;5sep2015pm012345.6789&quot;</span>, <span class="string">&quot;%d%b%Y%p%I%M%S%.f&quot;</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="ident">and_hms_micro</span>(<span class="number">13</span>, <span class="number">23</span>, <span class="number">45</span>, <span class="number">678_900</span>)));</code></pre></div>
<p>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">&quot;2014-5-17T12:34:56+09:30&quot;</span>, <span class="string">&quot;%Y-%m-%dT%H:%M:%S%z&quot;</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>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));</code></pre></div>
<p><a href="./struct.NaiveTime.html#leap-second-handling">Leap seconds</a> are correctly handled by
treating any time of the form <code>hh:mm:60</code> as a leap second.
(This equally applies to the formatting, so the round trip is possible.)</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">&quot;2015-07-01 08:59:60.123&quot;</span>, <span class="string">&quot;%Y-%m-%d %H:%M:%S%.f&quot;</span>),
<span class="prelude-val">Ok</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="ident">and_hms_milli</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_123</span>)));</code></pre></div>
<p>Missing seconds are assumed to be zero,
but out-of-bound times or insufficient fields are errors otherwise.</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">&quot;94/9/4 7:15&quot;</span>, <span class="string">&quot;%y/%m/%d %H:%M&quot;</span>),
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate::from_ymd</span>(<span class="number">1994</span>, <span class="number">9</span>, <span class="number">4</span>).<span class="ident">and_hms</span>(<span class="number">7</span>, <span class="number">15</span>, <span class="number">0</span>)));
<span class="macro">assert!</span>(<span class="ident">parse_from_str</span>(<span class="string">&quot;04m33s&quot;</span>, <span class="string">&quot;%Mm%Ss&quot;</span>).<span class="ident">is_err</span>());
<span class="macro">assert!</span>(<span class="ident">parse_from_str</span>(<span class="string">&quot;94/9/4 12&quot;</span>, <span class="string">&quot;%y/%m/%d %H&quot;</span>).<span class="ident">is_err</span>());
<span class="macro">assert!</span>(<span class="ident">parse_from_str</span>(<span class="string">&quot;94/9/4 17:60&quot;</span>, <span class="string">&quot;%y/%m/%d %H:%M&quot;</span>).<span class="ident">is_err</span>());
<span class="macro">assert!</span>(<span class="ident">parse_from_str</span>(<span class="string">&quot;94/9/4 24:00:00&quot;</span>, <span class="string">&quot;%y/%m/%d %H:%M:%S&quot;</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="kw">let</span> <span class="ident">fmt</span> <span class="op">=</span> <span class="string">&quot;%Y-%m-%d %H:%M:%S = UNIX timestamp %s&quot;</span>;
<span class="macro">assert!</span>(<span class="ident">parse_from_str</span>(<span class="string">&quot;2001-09-09 01:46:39 = UNIX timestamp 999999999&quot;</span>, <span class="ident">fmt</span>).<span class="ident">is_ok</span>());
<span class="macro">assert!</span>(<span class="ident">parse_from_str</span>(<span class="string">&quot;1970-01-01 00:00:00 = UNIX timestamp 1&quot;</span>, <span class="ident">fmt</span>).<span class="ident">is_err</span>());</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.date" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#237-239" title="goto source code">[src]</a></div><a href="#method.date" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.date" class="fnname">date</a>(&amp;self) -&gt; <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></div></summary><div class="docblock"><p>Retrieves a date component.</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::NaiveDate</span>;
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">date</span>(), <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>));</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.time" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#252-254" title="goto source code">[src]</a></div><a href="#method.time" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.time" class="fnname">time</a>(&amp;self) -&gt; <a class="struct" href="struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></h4></div></summary><div class="docblock"><p>Retrieves a time component.</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">NaiveTime</span>};
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">time</span>(), <span class="ident">NaiveTime::from_hms</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>));</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.timestamp" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#279-284" title="goto source code">[src]</a></div><a href="#method.timestamp" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.timestamp" class="fnname">timestamp</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i64.html">i64</a></h4></div></summary><div class="docblock"><p>Returns the number of non-leap seconds since the midnight on January 1, 1970.</p>
<p>Note that this does <em>not</em> account for the timezone!
The true “UNIX timestamp” would count seconds since the midnight <em>UTC</em> on the epoch.</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">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">980</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp</span>(), <span class="number">1</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp</span>(), <span class="number">1_000_000_000</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">1969</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp</span>(), <span class="op">-</span><span class="number">1</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</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="ident">and_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp</span>(), <span class="op">-</span><span class="number">62198755200</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.timestamp_millis" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#311-314" title="goto source code">[src]</a></div><a href="#method.timestamp_millis" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.timestamp_millis" class="fnname">timestamp_millis</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i64.html">i64</a></h4></div></summary><div class="docblock"><p>Returns the number of non-leap <em>milliseconds</em> since midnight on January 1, 1970.</p>
<p>Note that this does <em>not</em> account for the timezone!
The true “UNIX timestamp” would count seconds since the midnight <em>UTC</em> on the epoch.</p>
<p>Note also that this does reduce the number of years that can be
represented from ~584 Billion to ~584 Million. (If this is a problem,
please file an issue to let me know what domain needs millisecond
precision over billions of years, I’m curious.)</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::NaiveDate</span>;
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">444</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_millis</span>(), <span class="number">1_444</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).<span class="ident">and_hms_milli</span>(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>, <span class="number">555</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_millis</span>(), <span class="number">1_000_000_000_555</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">1969</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">100</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_millis</span>(), <span class="op">-</span><span class="number">900</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.timestamp_nanos" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#350-353" title="goto source code">[src]</a></div><a href="#method.timestamp_nanos" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.timestamp_nanos" class="fnname">timestamp_nanos</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i64.html">i64</a></h4></div></summary><div class="docblock"><p>Returns the number of non-leap <em>nanoseconds</em> since midnight on January 1, 1970.</p>
<p>Note that this does <em>not</em> account for the timezone!
The true “UNIX timestamp” would count seconds since the midnight <em>UTC</em> on the epoch.</p>
<h5 id="panics" class="section-header"><a href="#panics">Panics</a></h5>
<p>Note also that this does reduce the number of years that can be
represented from ~584 Billion to ~584 years. The dates that can be
represented as nanoseconds are between 1677-09-21T00:12:44.0 and
2262-04-11T23:47:16.854775804.</p>
<p>(If this is a problem, please file an issue to let me know what domain
needs nanosecond precision over millennia, I’m curious.)</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</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>};
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms_nano</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">444</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_nanos</span>(), <span class="number">1_000_000_444</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).<span class="ident">and_hms_nano</span>(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>, <span class="number">555</span>);
<span class="kw">const</span> <span class="ident">A_BILLION</span>: <span class="ident">i64</span> <span class="op">=</span> <span class="number">1_000_000_000</span>;
<span class="kw">let</span> <span class="ident">nanos</span> <span class="op">=</span> <span class="ident">dt</span>.<span class="ident">timestamp_nanos</span>();
<span class="macro">assert_eq!</span>(<span class="ident">nanos</span>, <span class="number">1_000_000_000_000_000_555</span>);
<span class="macro">assert_eq!</span>(
<span class="ident">dt</span>,
<span class="ident">NaiveDateTime::from_timestamp</span>(<span class="ident">nanos</span> <span class="op">/</span> <span class="ident">A_BILLION</span>, (<span class="ident">nanos</span> <span class="op">%</span> <span class="ident">A_BILLION</span>) <span class="kw">as</span> <span class="ident">u32</span>)
);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.timestamp_subsec_millis" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#372-374" title="goto source code">[src]</a></div><a href="#method.timestamp_subsec_millis" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.timestamp_subsec_millis" class="fnname">timestamp_subsec_millis</a>(&amp;self) -&gt; <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 number of milliseconds since the last whole non-leap second.</p>
<p>The return value ranges from 0 to 999,
or for <a href="./struct.NaiveTime.html#leap-second-handling">leap seconds</a>, to 1,999.</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::NaiveDate</span>;
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms_nano</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_millis</span>(), <span class="number">123</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</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="ident">and_hms_nano</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_millis</span>(), <span class="number">1_234</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.timestamp_subsec_micros" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#393-395" title="goto source code">[src]</a></div><a href="#method.timestamp_subsec_micros" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.timestamp_subsec_micros" class="fnname">timestamp_subsec_micros</a>(&amp;self) -&gt; <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 number of microseconds since the last whole non-leap second.</p>
<p>The return value ranges from 0 to 999,999,
or for <a href="./struct.NaiveTime.html#leap-second-handling">leap seconds</a>, to 1,999,999.</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::NaiveDate</span>;
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms_nano</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_micros</span>(), <span class="number">123_456</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</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="ident">and_hms_nano</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_micros</span>(), <span class="number">1_234_567</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.timestamp_subsec_nanos" class="method has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#414-416" title="goto source code">[src]</a></div><a href="#method.timestamp_subsec_nanos" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.timestamp_subsec_nanos" class="fnname">timestamp_subsec_nanos</a>(&amp;self) -&gt; <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 number of nanoseconds since the last whole non-leap second.</p>
<p>The return value ranges from 0 to 999,999,999,
or for <a href="./struct.NaiveTime.html#leap-second-handling">leap seconds</a>, to 1,999,999,999.</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">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms_nano</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_nanos</span>(), <span class="number">123_456_789</span>);
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</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="ident">and_hms_nano</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_nanos</span>(), <span class="number">1_234_567_890</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/datetime.rs.html#489-499" 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>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Adds given <code>Duration</code> to the current date and time.</p>
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
the addition assumes that <strong>there is no leap second ever</strong>,
except when the <code>NaiveDateTime</code> itself represents a leap second
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
<p>Returns <code>None</code> when it will result in overflow.</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">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">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="kw">let</span> <span class="ident">hms</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>);
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration::zero</span>()),
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration::seconds</span>(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration::seconds</span>(<span class="op">-</span><span class="number">1</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration::seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">4</span>, <span class="number">6</span>, <span class="number">7</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration::seconds</span>(<span class="number">86_400</span>)),
<span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
<span class="kw">let</span> <span class="ident">hmsm</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span>);
<span class="macro">assert_eq!</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">980</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration::milliseconds</span>(<span class="number">450</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>, <span class="number">430</span>)));</code></pre></div>
<p>Overflow returns <code>None</code>.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</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>);</code></pre></div>
<p>Leap seconds are handled,
but the addition assumes that it is the only leap second happened.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::zero</span>()),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::milliseconds</span>(<span class="op">-</span><span class="number">500</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::milliseconds</span>(<span class="number">500</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_800</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::milliseconds</span>(<span class="number">800</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">100</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::seconds</span>(<span class="number">10</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">9</span>, <span class="number">300</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::seconds</span>(<span class="op">-</span><span class="number">10</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">50</span>, <span class="number">300</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration::days</span>(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms_milli</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">300</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/datetime.rs.html#568-578" 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>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Subtracts given <code>Duration</code> from the current date and time.</p>
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
the subtraction assumes that <strong>there is no leap second ever</strong>,
except when the <code>NaiveDateTime</code> itself represents a leap second
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
<p>Returns <code>None</code> when it will result in overflow.</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</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">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="kw">let</span> <span class="ident">hms</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>);
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::zero</span>()),
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::seconds</span>(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::seconds</span>(<span class="op">-</span><span class="number">1</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">7</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::seconds</span>(<span class="number">86_400</span>)),
<span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
<span class="kw">let</span> <span class="ident">hmsm</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span>);
<span class="macro">assert_eq!</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">450</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::milliseconds</span>(<span class="number">670</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">780</span>)));</code></pre></div>
<p>Overflow returns <code>None</code>.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</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>);</code></pre></div>
<p>Leap seconds are handled,
but the subtraction assumes that it is the only leap second happened.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::zero</span>()),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::milliseconds</span>(<span class="number">200</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_100</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::milliseconds</span>(<span class="number">500</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::seconds</span>(<span class="number">60</span>)),
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">0</span>, <span class="number">300</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration::days</span>(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).<span class="ident">and_hms_milli</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">300</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/datetime.rs.html#622-624" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -&gt; <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a></h4></div></summary><div class="docblock"><p>Subtracts another <code>NaiveDateTime</code> from the current date and time.
This does not overflow or underflow at all.</p>
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
the subtraction assumes that <strong>there is no leap second ever</strong>,
except when any of the <code>NaiveDateTime</code>s themselves represents a leap second
in which case the assumption becomes that
<strong>there are exactly one (or two) leap second(s) ever</strong>.</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">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">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">signed_duration_since</span>(<span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">6</span>)),
<span class="ident">Duration::seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span> <span class="op">+</span> <span class="number">1</span>));
<span class="comment">// July 8 is 190th day in the year 2016</span>
<span class="kw">let</span> <span class="ident">d0</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>);
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">7</span>, <span class="number">6</span>, <span class="number">500</span>).<span class="ident">signed_duration_since</span>(<span class="ident">d0</span>.<span class="ident">and_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>)),
<span class="ident">Duration::seconds</span>(<span class="number">189</span> <span class="op">*</span> <span class="number">86_400</span> <span class="op">+</span> <span class="number">7</span> <span class="op">*</span> <span class="number">60</span> <span class="op">+</span> <span class="number">6</span>) <span class="op">+</span> <span class="ident">Duration::milliseconds</span>(<span class="number">500</span>));</code></pre></div>
<p>Leap seconds are handled, but the subtraction assumes that
there were no other leap seconds happened.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>);
<span class="macro">assert_eq!</span>(<span class="ident">leap</span>.<span class="ident">signed_duration_since</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">0</span>, <span class="number">0</span>)),
<span class="ident">Duration::seconds</span>(<span class="number">3600</span>) <span class="op">+</span> <span class="ident">Duration::milliseconds</span>(<span class="number">500</span>));
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms</span>(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">signed_duration_since</span>(<span class="ident">leap</span>),
<span class="ident">Duration::seconds</span>(<span class="number">3600</span>) <span class="op">-</span> <span class="ident">Duration::milliseconds</span>(<span class="number">500</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/datetime.rs.html#655-661" 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>&lt;'a, I, B&gt;(&amp;self, items: I) -&gt; <a class="struct" href="../format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a>&lt;I&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;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>&lt;Item = B&gt; + <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>&nbsp;&nbsp;&nbsp;&nbsp;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>&lt;<a class="enum" href="../format/enum.Item.html" title="enum chrono::format::Item">Item</a>&lt;'a&gt;&gt;,&nbsp;</span></h4></div></summary><div class="docblock"><p>Formats the combined date and time with the specified formatting items.
Otherwise it is the same as the ordinary <a href="#method.format"><code>format</code></a> 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-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">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">&quot;%Y-%m-%d %H:%M:%S&quot;</span>);
<span class="kw">let</span> <span class="ident">dt</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="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</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">&quot;2015-09-05 23:56:04&quot;</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">&quot;%Y-%m-%d %H:%M:%S&quot;</span>).<span class="ident">to_string</span>(), <span class="string">&quot;2015-09-05 23:56:04&quot;</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">&quot;{}&quot;</span>, <span class="ident">dt</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>)), <span class="string">&quot;2015-09-05 23:56:04&quot;</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/datetime.rs.html#697-699" 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>&lt;'a&gt;(&amp;self, fmt: &amp;'a <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.str.html">str</a>) -&gt; <a class="struct" href="../format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a>&lt;<a class="struct" href="../format/strftime/struct.StrftimeItems.html" title="struct chrono::format::strftime::StrftimeItems">StrftimeItems</a>&lt;'a&gt;&gt;</h4></div></summary><div class="docblock"><p>Formats the combined date and time 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-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::NaiveDate</span>;
<span class="kw">let</span> <span class="ident">dt</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="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">&quot;%Y-%m-%d %H:%M:%S&quot;</span>).<span class="ident">to_string</span>(), <span class="string">&quot;2015-09-05 23:56:04&quot;</span>);
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">&quot;around %l %p on %b %-d&quot;</span>).<span class="ident">to_string</span>(), <span class="string">&quot;around 11 PM on Sep 5&quot;</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">&quot;{}&quot;</span>, <span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">&quot;%Y-%m-%d %H:%M:%S&quot;</span>)), <span class="string">&quot;2015-09-05 23:56:04&quot;</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">&quot;{}&quot;</span>, <span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">&quot;around %l %p on %b %-d&quot;</span>)), <span class="string">&quot;around 11 PM on Sep 5&quot;</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/datetime.rs.html#1252-1259" 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>&lt;<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="docblock"><p>An addition of <code>Duration</code> to <code>NaiveDateTime</code> yields another <code>NaiveDateTime</code>.</p>
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
the addition assumes that <strong>there is no leap second ever</strong>,
except when the <code>NaiveDateTime</code> itself represents a leap second
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
<p>Panics on underflow or overflow.
Use <a href="#method.checked_add_signed"><code>NaiveDateTime::checked_add_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="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="kw">let</span> <span class="ident">hms</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>);
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration::zero</span>(), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration::seconds</span>(<span class="number">1</span>), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration::seconds</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration::seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span>), <span class="ident">hms</span>(<span class="number">4</span>, <span class="number">6</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration::seconds</span>(<span class="number">86_400</span>),
<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration::days</span>(<span class="number">365</span>),
<span class="ident">from_ymd</span>(<span class="number">2017</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
<span class="kw">let</span> <span class="ident">hmsm</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span>);
<span class="macro">assert_eq!</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">980</span>) <span class="op">+</span> <span class="ident">Duration::milliseconds</span>(<span class="number">450</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>, <span class="number">430</span>));</code></pre></div>
<p>Leap seconds are handled,
but the addition assumes that it is the only leap second happened.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration::zero</span>(), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration::milliseconds</span>(<span class="op">-</span><span class="number">500</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration::milliseconds</span>(<span class="number">500</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_800</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration::milliseconds</span>(<span class="number">800</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">100</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration::seconds</span>(<span class="number">10</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">9</span>, <span class="number">300</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration::seconds</span>(<span class="op">-</span><span class="number">10</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">50</span>, <span class="number">300</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</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">2016</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms_milli</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">300</span>));</code></pre></div>
</div><div class="impl-items"><details class="rustdoc-toggle" open><summary><div id="associatedtype.Output-4" class="type trait-impl has-srclink"><a href="#associatedtype.Output-4" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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-1" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1256-1258" title="goto source code">[src]</a></div><a href="#method.add-1" 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>) -&gt; <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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-Add%3CFixedOffset%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#182-189" title="goto source code">[src]</a></div><a href="#impl-Add%3CFixedOffset%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>&lt;<a class="struct" href="../offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><div id="associatedtype.Output-3" class="type trait-impl has-srclink"><a href="#associatedtype.Output-3" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/offset/fixed.rs.html#186-188" 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="../offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>) -&gt; <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#1261-1266" 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>&lt;<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#1263-1265" 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>(&amp;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/datetime.rs.html#61" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#61" 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>(&amp;self) -&gt; <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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>(&amp;mut self, source: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;</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/datetime.rs.html#702-1018" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#716-718" 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>(&amp;self) -&gt; <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="./index.html#calendar-date">calendar date</a>.</p>
<p>See also the <a href="./struct.NaiveDate.html#method.year"><code>NaiveDate::year</code></a> method.</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</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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>);</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/datetime.rs.html#735-737" 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>(&amp;self) -&gt; <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>
<p>See also the <a href="./struct.NaiveDate.html#method.month"><code>NaiveDate::month</code></a> method.</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</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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">month</span>(), <span class="number">9</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/datetime.rs.html#754-756" 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>(&amp;self) -&gt; <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>
<p>See also the <a href="./struct.NaiveDate.html#method.month0"><code>NaiveDate::month0</code></a> method.</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</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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">month0</span>(), <span class="number">8</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/datetime.rs.html#773-775" 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>(&amp;self) -&gt; <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>
<p>See also the <a href="./struct.NaiveDate.html#method.day"><code>NaiveDate::day</code></a> method.</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</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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">day</span>(), <span class="number">25</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/datetime.rs.html#792-794" 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>(&amp;self) -&gt; <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>
<p>See also the <a href="./struct.NaiveDate.html#method.day0"><code>NaiveDate::day0</code></a> method.</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</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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">day0</span>(), <span class="number">24</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/datetime.rs.html#811-813" 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>(&amp;self) -&gt; <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>
<p>See also the <a href="./struct.NaiveDate.html#method.ordinal"><code>NaiveDate::ordinal</code></a> method.</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">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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">ordinal</span>(), <span class="number">268</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/datetime.rs.html#830-832" 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>(&amp;self) -&gt; <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>
<p>See also the <a href="./struct.NaiveDate.html#method.ordinal0"><code>NaiveDate::ordinal0</code></a> method.</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">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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">ordinal0</span>(), <span class="number">267</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/datetime.rs.html#847-849" 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>(&amp;self) -&gt; <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>
<p>See also the <a href="./struct.NaiveDate.html#method.weekday"><code>NaiveDate::weekday</code></a> method.</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">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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">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/datetime.rs.html#873-875" 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>(&amp;self, year: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.i32.html">i32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the year number changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveDate.html#method.with_year"><code>NaiveDate::with_year</code></a> method.</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</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">25</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">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">25</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">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">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</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/datetime.rs.html#895-897" 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>(&amp;self, month: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the month number (starting from 1) changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveDate.html#method.with_month"><code>NaiveDate::with_month</code></a> method.</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</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">30</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">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">30</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">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">dt</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/datetime.rs.html#917-919" 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>(&amp;self, month0: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the month number (starting from 0) changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveDate.html#method.with_month0"><code>NaiveDate::with_month0</code></a> method.</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">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">30</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">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">30</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">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">dt</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/datetime.rs.html#938-940" 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>(&amp;self, day: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of month (starting from 1) changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveDate.html#method.with_day"><code>NaiveDate::with_day</code></a> method.</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">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">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="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">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/datetime.rs.html#959-961" 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>(&amp;self, day0: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of month (starting from 0) changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveDate.html#method.with_day0"><code>NaiveDate::with_day0</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">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="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">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/datetime.rs.html#987-989" 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>(&amp;self, ordinal: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of year (starting from 1) changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveDate.html#method.with_ordinal"><code>NaiveDate::with_ordinal</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">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="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">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="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</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="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">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="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">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>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</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/datetime.rs.html#1015-1017" 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>(&amp;self, ordinal0: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of year (starting from 0) changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveDate.html#method.with_ordinal0"><code>NaiveDate::with_ordinal0</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Datelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">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="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">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="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</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="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">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="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">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>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</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/datetime.rs.html#852-854" 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>(&amp;self) -&gt; <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>(&amp;self) -&gt; <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>(&amp;self) -&gt; <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/datetime.rs.html#1416-1420" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="docblock"><p>The <code>Debug</code> output of the naive date and time <code>dt</code> is the same as
<a href="../format/strftime/index.html"><code>dt.format(&quot;%Y-%m-%dT%H:%M:%S%.f&quot;)</code></a>.</p>
<p>The string printed can be readily parsed via the <code>parse</code> method on <code>str</code>.</p>
<p>It should be noted that, for leap seconds not on the minute boundary,
it may print a representation not distinguishable from non-leap seconds.
This doesn’t matter in practice, since such leap seconds never happened.
(By the time of the first leap second on 1972-06-30,
every time zone offset around the world has standardized to the 5-minute alignment.)</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::NaiveDate</span>;
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">11</span>, <span class="number">15</span>).<span class="ident">and_hms</span>(<span class="number">7</span>, <span class="number">39</span>, <span class="number">24</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">&quot;{:?}&quot;</span>, <span class="ident">dt</span>), <span class="string">&quot;2016-11-15T07:39:24&quot;</span>);</code></pre></div>
<p>Leap seconds may also be used.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let</span> <span class="ident">dt</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">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">&quot;{:?}&quot;</span>, <span class="ident">dt</span>), <span class="string">&quot;2015-06-30T23:59:60.500&quot;</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/datetime.rs.html#1417-1419" 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>(&amp;self, f: &amp;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>&lt;'_&gt;) -&gt; <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/datetime.rs.html#1447-1451" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="docblock"><p>The <code>Display</code> output of the naive date and time <code>dt</code> is the same as
<a href="../format/strftime/index.html"><code>dt.format(&quot;%Y-%m-%d %H:%M:%S%.f&quot;)</code></a>.</p>
<p>It should be noted that, for leap seconds not on the minute boundary,
it may print a representation not distinguishable from non-leap seconds.
This doesn’t matter in practice, since such leap seconds never happened.
(By the time of the first leap second on 1972-06-30,
every time zone offset around the world has standardized to the 5-minute alignment.)</p>
<h4 id="example-43" class="section-header"><a href="#example-43">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">dt</span> <span class="op">=</span> <span class="ident">NaiveDate::from_ymd</span>(<span class="number">2016</span>, <span class="number">11</span>, <span class="number">15</span>).<span class="ident">and_hms</span>(<span class="number">7</span>, <span class="number">39</span>, <span class="number">24</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">&quot;{}&quot;</span>, <span class="ident">dt</span>), <span class="string">&quot;2016-11-15 07:39:24&quot;</span>);</code></pre></div>
<p>Leap seconds may also be used.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let</span> <span class="ident">dt</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">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">&quot;{}&quot;</span>, <span class="ident">dt</span>), <span class="string">&quot;2015-06-30 23:59:60.500&quot;</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/datetime.rs.html#1448-1450" 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>(&amp;self, f: &amp;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>&lt;'_&gt;) -&gt; <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/datetime.rs.html#1469-1498" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="docblock"><p>Parsing a <code>str</code> into a <code>NaiveDateTime</code> uses the same format,
<a href="../format/strftime/index.html"><code>%Y-%m-%dT%H:%M:%S%.f</code></a>, as in <code>Debug</code>.</p>
<h4 id="example-44" class="section-header"><a href="#example-44">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">NaiveDateTime</span>, <span class="ident">NaiveDate</span>};
<span class="kw">let</span> <span class="ident">dt</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="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
<span class="macro">assert_eq!</span>(<span class="string">&quot;2015-09-18T23:56:04&quot;</span>.<span class="ident">parse</span>::<span class="op">&lt;</span><span class="ident">NaiveDateTime</span><span class="op">&gt;</span>(), <span class="prelude-val">Ok</span>(<span class="ident">dt</span>));
<span class="kw">let</span> <span class="ident">dt</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="ident">and_hms_milli</span>(<span class="number">7</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>); <span class="comment">// leap second</span>
<span class="macro">assert_eq!</span>(<span class="string">&quot;+12345-6-7T7:59:60.5&quot;</span>.<span class="ident">parse</span>::<span class="op">&lt;</span><span class="ident">NaiveDateTime</span><span class="op">&gt;</span>(), <span class="prelude-val">Ok</span>(<span class="ident">dt</span>));
<span class="macro">assert!</span>(<span class="string">&quot;foo&quot;</span>.<span class="ident">parse</span>::<span class="op">&lt;</span><span class="ident">NaiveDateTime</span><span class="op">&gt;</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/datetime.rs.html#1472-1497" 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: &amp;<a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.str.html">str</a>) -&gt; <a class="type" href="../format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</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/datetime.rs.html#1192-1197" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="docblock"><p><code>NaiveDateTime</code> can be used as a key to the hash maps (in principle).</p>
<p>Practically this also takes account of fractional seconds, so it is not recommended.
(For the obvious reason this also distinguishes leap seconds from non-leap seconds.)</p>
</div><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/datetime.rs.html#1193-1196" 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>&lt;H:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.59.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>&gt;(&amp;self, state: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;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>&lt;H&gt;(data: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.slice.html">&amp;[Self]</a>, state: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;mut </a>H) <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;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>,&nbsp;</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/datetime.rs.html#61" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#61" 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>(&amp;self, other: &amp;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -&gt; <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) -&gt; 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) -&gt; 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) -&gt; 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%3CNaiveDateTime%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></div><a href="#impl-PartialEq%3CNaiveDateTime%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>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#61" 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>(&amp;self, other: &amp;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -&gt; <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/datetime.rs.html#61" 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>(&amp;self, other: &amp;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -&gt; <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%3CNaiveDateTime%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></div><a href="#impl-PartialOrd%3CNaiveDateTime%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>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#61" 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>(&amp;self, other: &amp;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="enum" href="https://doc.rust-lang.org/1.59.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a>&gt;</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>(&amp;self, other: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;</a>Rhs) -&gt; <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>&lt;</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>(&amp;self, other: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;</a>Rhs) -&gt; <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>&lt;=</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>(&amp;self, other: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;</a>Rhs) -&gt; <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>&gt;</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>(&amp;self, other: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;</a>Rhs) -&gt; <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>&gt;=</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/datetime.rs.html#1320-1327" 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>&lt;<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="docblock"><p>A subtraction of <code>Duration</code> from <code>NaiveDateTime</code> yields another <code>NaiveDateTime</code>.
It is the same as the addition with a negated <code>Duration</code>.</p>
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
the addition assumes that <strong>there is no leap second ever</strong>,
except when the <code>NaiveDateTime</code> itself represents a leap second
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
<p>Panics on underflow or overflow.
Use <a href="#method.checked_sub_signed"><code>NaiveDateTime::checked_sub_signed</code></a> to detect that.</p>
<h4 id="example-41" class="section-header"><a href="#example-41">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="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="kw">let</span> <span class="ident">hms</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>);
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration::zero</span>(), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration::seconds</span>(<span class="number">1</span>), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration::seconds</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration::seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span>), <span class="ident">hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration::seconds</span>(<span class="number">86_400</span>),
<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration::days</span>(<span class="number">365</span>),
<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
<span class="kw">let</span> <span class="ident">hmsm</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span>);
<span class="macro">assert_eq!</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">450</span>) <span class="op">-</span> <span class="ident">Duration::milliseconds</span>(<span class="number">670</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">780</span>));</code></pre></div>
<p>Leap seconds are handled,
but the subtraction assumes that it is the only leap second happened.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration::zero</span>(), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration::milliseconds</span>(<span class="number">200</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_100</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration::milliseconds</span>(<span class="number">500</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration::seconds</span>(<span class="number">60</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">0</span>, <span class="number">300</span>));
<span class="macro">assert_eq!</span>(<span class="ident">leap</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">2016</span>, <span class="number">7</span>, <span class="number">7</span>).<span class="ident">and_hms_milli</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">300</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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#1324-1326" 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.Duration.html" title="struct chrono::Duration">OldDuration</a>) -&gt; <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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%3CFixedOffset%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#191-198" title="goto source code">[src]</a></div><a href="#impl-Sub%3CFixedOffset%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>&lt;<a class="struct" href="../offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/offset/fixed.rs.html#195-197" 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="../offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>) -&gt; <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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%3CNaiveDateTime%3E" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1380-1387" title="goto source code">[src]</a></div><a href="#impl-Sub%3CNaiveDateTime%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>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="docblock"><p>Subtracts another <code>NaiveDateTime</code> from the current date and time.
This does not overflow or underflow at all.</p>
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
the subtraction assumes that <strong>there is no leap second ever</strong>,
except when any of the <code>NaiveDateTime</code>s themselves represents a leap second
in which case the assumption becomes that
<strong>there are exactly one (or two) leap second(s) ever</strong>.</p>
<p>The implementation is a wrapper around
<a href="#method.signed_duration_since"><code>NaiveDateTime::signed_duration_since</code></a>.</p>
<h4 id="example-42" class="section-header"><a href="#example-42">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="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">6</span>), <span class="ident">Duration::seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span> <span class="op">+</span> <span class="number">1</span>));
<span class="comment">// July 8 is 190th day in the year 2016</span>
<span class="kw">let</span> <span class="ident">d0</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>);
<span class="macro">assert_eq!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">7</span>, <span class="number">6</span>, <span class="number">500</span>) <span class="op">-</span> <span class="ident">d0</span>.<span class="ident">and_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>),
<span class="ident">Duration::seconds</span>(<span class="number">189</span> <span class="op">*</span> <span class="number">86_400</span> <span class="op">+</span> <span class="number">7</span> <span class="op">*</span> <span class="number">60</span> <span class="op">+</span> <span class="number">6</span>) <span class="op">+</span> <span class="ident">Duration::milliseconds</span>(<span class="number">500</span>));</code></pre></div>
<p>Leap seconds are handled, but the subtraction assumes that
there were no other leap seconds happened.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>);
<span class="macro">assert_eq!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">0</span>, <span class="number">0</span>),
<span class="ident">Duration::seconds</span>(<span class="number">3600</span>) <span class="op">+</span> <span class="ident">Duration::milliseconds</span>(<span class="number">500</span>));
<span class="macro">assert_eq!</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms</span>(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">leap</span>,
<span class="ident">Duration::seconds</span>(<span class="number">3600</span>) <span class="op">-</span> <span class="ident">Duration::milliseconds</span>(<span class="number">500</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.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-2" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1384-1386" title="goto source code">[src]</a></div><a href="#method.sub-2" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -&gt; <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/datetime.rs.html#1329-1334" 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>&lt;<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>&gt; for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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/datetime.rs.html#1331-1333" 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>(&amp;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><details class="rustdoc-toggle implementors-toggle" open><summary><div id="impl-Timelike" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1020-1186" title="goto source code">[src]</a></div><a href="#impl-Timelike" class="anchor"></a><h3 class="code-header in-band">impl <a class="trait" href="../trait.Timelike.html" title="trait chrono::Timelike">Timelike</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><div id="method.hour" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1034-1036" title="goto source code">[src]</a></div><a href="#method.hour" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.hour" class="fnname">hour</a>(&amp;self) -&gt; <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 hour number from 0 to 23.</p>
<p>See also the <a href="./struct.NaiveTime.html#method.hour"><code>NaiveTime::hour</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Timelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">hour</span>(), <span class="number">12</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.minute" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1051-1053" title="goto source code">[src]</a></div><a href="#method.minute" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.minute" class="fnname">minute</a>(&amp;self) -&gt; <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 minute number from 0 to 59.</p>
<p>See also the <a href="./struct.NaiveTime.html#method.minute"><code>NaiveTime::minute</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Timelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">minute</span>(), <span class="number">34</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.second" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1068-1070" title="goto source code">[src]</a></div><a href="#method.second" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.second" class="fnname">second</a>(&amp;self) -&gt; <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 second number from 0 to 59.</p>
<p>See also the <a href="./struct.NaiveTime.html#method.second"><code>NaiveTime::second</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Timelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">second</span>(), <span class="number">56</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.nanosecond" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1088-1090" title="goto source code">[src]</a></div><a href="#method.nanosecond" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.nanosecond" class="fnname">nanosecond</a>(&amp;self) -&gt; <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 number of nanoseconds since the whole non-leap second.
The range from 1,000,000,000 to 1,999,999,999 represents
the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
<p>See also the
<a href="./struct.NaiveTime.html#method.nanosecond"><code>NaiveTime::nanosecond</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Timelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">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.with_hour" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1110-1112" title="goto source code">[src]</a></div><a href="#method.with_hour" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.with_hour" class="fnname">with_hour</a>(&amp;self, hour: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the hour number changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveTime.html#method.with_hour"><code>NaiveTime::with_hour</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Timelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">with_hour</span>(<span class="number">7</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">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">7</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">with_hour</span>(<span class="number">24</span>), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.with_minute" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1132-1134" title="goto source code">[src]</a></div><a href="#method.with_minute" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.with_minute" class="fnname">with_minute</a>(&amp;self, min: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the minute number changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
<p>See also the
<a href="./struct.NaiveTime.html#method.with_minute"><code>NaiveTime::with_minute</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Timelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">with_minute</span>(<span class="number">45</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">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">45</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">with_minute</span>(<span class="number">60</span>), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.with_second" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1156-1158" title="goto source code">[src]</a></div><a href="#method.with_second" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.with_second" class="fnname">with_second</a>(&amp;self, sec: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the second number changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.
As with the <a href="#method.second"><code>second</code></a> method,
the input range is restricted to 0 through 59.</p>
<p>See also the
<a href="./struct.NaiveTime.html#method.with_second"><code>NaiveTime::with_second</code></a> method.</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">NaiveDateTime</span>, <span class="ident">Timelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">with_second</span>(<span class="number">17</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">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">17</span>, <span class="number">789</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">with_second</span>(<span class="number">60</span>), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.with_nanosecond" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1183-1185" title="goto source code">[src]</a></div><a href="#method.with_nanosecond" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.with_nanosecond" class="fnname">with_nanosecond</a>(&amp;self, nano: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.u32.html">u32</a>) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>&gt;</h4></div></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with nanoseconds since the whole non-leap second changed.</p>
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.
As with the <a href="#method.nanosecond"><code>nanosecond</code></a> method,
the input range can exceed 1,000,000,000 for leap seconds.</p>
<p>See also the
<a href="./struct.NaiveTime.html#method.with_nanosecond"><code>NaiveTime::with_nanosecond</code></a>
method.</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">NaiveDateTime</span>, <span class="ident">Timelike</span>};
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</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">8</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">with_nanosecond</span>(<span class="number">333_333_333</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">8</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">333_333_333</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">with_nanosecond</span>(<span class="number">1_333_333_333</span>), <span class="comment">// leap second</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">8</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">1_333_333_333</span>)));
<span class="macro">assert_eq!</span>(<span class="ident">dt</span>.<span class="ident">with_nanosecond</span>(<span class="number">2_000_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.hour12" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/lib.rs.html#1370-1377" title="goto source code">[src]</a></div><a href="#method.hour12" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#method.hour12" class="fnname">hour12</a>(&amp;self) -&gt; <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 hour number from 1 to 12 with a boolean flag,
which is false for AM and true for PM. <a href="../trait.Timelike.html#method.hour12">Read more</a></p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><div id="method.num_seconds_from_midnight" class="method trait-impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/lib.rs.html#1416-1418" title="goto source code">[src]</a></div><a href="#method.num_seconds_from_midnight" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Timelike.html#method.num_seconds_from_midnight" class="fnname">num_seconds_from_midnight</a>(&amp;self) -&gt; <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 number of non-leap seconds past the last midnight.</p>
</div></details></div></details><div id="impl-Copy" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div><div id="impl-Eq" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div><div id="impl-StructuralEq" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></div><div id="impl-StructuralPartialEq" class="impl has-srclink"><div class="rightside"><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" 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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</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&lt;T&gt; <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>&nbsp;&nbsp;&nbsp;&nbsp;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>,&nbsp;</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>(&amp;self) -&gt; <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&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a>&lt;T&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;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>,&nbsp;</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>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;</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&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a>&lt;T&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;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>,&nbsp;</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>(&amp;mut self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;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&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;T&gt; 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) -&gt; 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&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;U&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;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>&lt;T&gt;,&nbsp;</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) -&gt; 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&lt;T&gt; <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>&nbsp;&nbsp;&nbsp;&nbsp;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>,&nbsp;</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>(&amp;self) -&gt; 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>(&amp;self, target: <a class="primitive" href="https://doc.rust-lang.org/1.59.0/std/primitive.reference.html">&amp;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&lt;T&gt; <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>&nbsp;&nbsp;&nbsp;&nbsp;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>,&nbsp;</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>(&amp;self) -&gt; <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&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;U&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;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>&lt;T&gt;,&nbsp;</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) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, &lt;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>&lt;U&gt;&gt;::<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>&gt;</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&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.59.0/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a>&lt;U&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;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>&lt;T&gt;,&nbsp;</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> = &lt;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>&lt;T&gt;&gt;::<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) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.59.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;U, &lt;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>&lt;T&gt;&gt;::<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>&gt;</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>
Reference in New Issue View Git Blame Copy Permalink