<!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."><title>NaiveDateTime in chrono::naive - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceSerif4-Regular-46f98efaafac5295.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/FiraSans-Regular-018c141bf0843ffd.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/FiraSans-Medium-8f9a781e4970d388.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceCodePro-Regular-562dcc5011b6de7d.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceSerif4-Bold-a2c9cd1067f8b328.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../static.files/SourceCodePro-Semibold-d899c5a5c4aeb14a.ttf.woff2"><link rel="stylesheet" href="../../static.files/normalize-76eba96aa4d2e634.css"><link rel="stylesheet" href="../../static.files/rustdoc-c4dbdcde0fbd8430.css" id="mainThemeStyle"><link rel="stylesheet" id="themeStyle" href="../../static.files/light-db279b6232be9c13.css"><link rel="stylesheet" disabled href="../../static.files/dark-cf923f49f397b216.css"><link rel="stylesheet" disabled href="../../static.files/ayu-be46fdc453a55015.css"><script src="../../static.files/storage-3891ce972e3a2bf8.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../static.files/main-98a684e84ae5b08b.js"></script><noscript><link rel="stylesheet" href="../../static.files/noscript-13285aec31fa243e.css"></noscript><link rel="alternate icon" type="image/png" href="../../static.files/favicon-16x16-8b506e7a72182f1c.png"><link rel="alternate icon" type="image/png" href="../../static.files/favicon-32x32-422f7d1d52889060.png"><link rel="icon" type="image/svg+xml" href="../../static.files/favicon-2c020d218678b618.svg"></head><body class="rustdoc struct"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">☰</button><a class="logo-container" href="../../chrono/index.html"><img class="rust-logo" src="../../static.files/rust-logo-151179464ae7ed46.svg" alt="logo"></a><h2></h2></nav><nav class="sidebar"><a class="logo-container" href="../../chrono/index.html"><img class="rust-logo" src="../../static.files/rust-logo-151179464ae7ed46.svg" alt="logo"></a><h2 class="location"><a href="#">NaiveDateTime</a></h2><div class="sidebar-elems"><section><h3><a href="#implementations">Associated Constants</a></h3><ul class="block"><li><a href="#associatedconstant.MAX">MAX</a></li><li><a href="#associatedconstant.MIN">MIN</a></li><li><a href="#associatedconstant.UNIX_EPOCH">UNIX_EPOCH</a></li></ul><h3><a href="#implementations">Methods</a></h3><ul class="block"><li><a href="#method.and_local_timezone">and_local_timezone</a></li><li><a href="#method.and_utc">and_utc</a></li><li><a href="#method.checked_add_days">checked_add_days</a></li><li><a href="#method.checked_add_months">checked_add_months</a></li><li><a href="#method.checked_add_signed">checked_add_signed</a></li><li><a href="#method.checked_sub_days">checked_sub_days</a></li><li><a href="#method.checked_sub_months">checked_sub_months</a></li><li><a href="#method.checked_sub_signed">checked_sub_signed</a></li><li><a href="#method.date">date</a></li><li><a href="#method.format">format</a></li><li><a href="#method.format_with_items">format_with_items</a></li><li><a href="#method.from_timestamp">from_timestamp</a></li><li><a href="#method.from_timestamp_micros">from_timestamp_micros</a></li><li><a href="#method.from_timestamp_millis">from_timestamp_millis</a></li><li><a href="#method.from_timestamp_opt">from_timestamp_opt</a></li><li><a href="#method.new">new</a></li><li><a href="#method.parse_and_remainder">parse_and_remainder</a></li><li><a href="#method.parse_from_str">parse_from_str</a></li><li><a href="#method.signed_duration_since">signed_duration_since</a></li><li><a href="#method.time">time</a></li><li><a href="#method.timestamp">timestamp</a></li><li><a href="#method.timestamp_micros">timestamp_micros</a></li><li><a href="#method.timestamp_millis">timestamp_millis</a></li><li><a href="#method.timestamp_nanos">timestamp_nanos</a></li><li><a href="#method.timestamp_nanos_opt">timestamp_nanos_opt</a></li><li><a href="#method.timestamp_subsec_micros">timestamp_subsec_micros</a></li><li><a href="#method.timestamp_subsec_millis">timestamp_subsec_millis</a></li><li><a href="#method.timestamp_subsec_nanos">timestamp_subsec_nanos</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block"><li><a href="#impl-Add%3CDays%3E-for-NaiveDateTime">Add<Days></a></li><li><a href="#impl-Add%3CDuration%3E-for-NaiveDateTime">Add<Duration></a></li><li><a href="#impl-Add%3CDuration%3E-for-NaiveDateTime-1">Add<Duration></a></li><li><a href="#impl-Add%3CFixedOffset%3E-for-NaiveDateTime">Add<FixedOffset></a></li><li><a href="#impl-Add%3CMonths%3E-for-NaiveDateTime">Add<Months></a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-NaiveDateTime">AddAssign<Duration></a></li><li><a href="#impl-AddAssign%3CDuration%3E-for-NaiveDateTime-1">AddAssign<Duration></a></li><li><a href="#impl-Clone-for-NaiveDateTime">Clone</a></li><li><a href="#impl-Copy-for-NaiveDateTime">Copy</a></li><li><a href="#impl-Datelike-for-NaiveDateTime">Datelike</a></li><li><a href="#impl-Debug-for-NaiveDateTime">Debug</a></li><li><a href="#impl-Default-for-NaiveDateTime">Default</a></li><li><a href="#impl-Display-for-NaiveDateTime">Display</a></li><li><a href="#impl-DurationRound-for-NaiveDateTime">DurationRound</a></li><li><a href="#impl-Eq-for-NaiveDateTime">Eq</a></li><li><a href="#impl-From%3CNaiveDateTime%3E-for-NaiveDate">From<NaiveDateTime></a></li><li><a href="#impl-FromStr-for-NaiveDateTime">FromStr</a></li><li><a href="#impl-Hash-for-NaiveDateTime">Hash</a></li><li><a href="#impl-Ord-for-NaiveDateTime">Ord</a></li><li><a href="#impl-PartialEq%3CNaiveDateTime%3E-for-NaiveDateTime">PartialEq<NaiveDateTime></a></li><li><a href="#impl-PartialOrd%3CNaiveDateTime%3E-for-NaiveDateTime">PartialOrd<NaiveDateTime></a></li><li><a href="#impl-StructuralEq-for-NaiveDateTime">StructuralEq</a></li><li><a href="#impl-StructuralPartialEq-for-NaiveDateTime">StructuralPartialEq</a></li><li><a href="#impl-Sub%3CDays%3E-for-NaiveDateTime">Sub<Days></a></li><li><a href="#impl-Sub%3CDuration%3E-for-NaiveDateTime">Sub<Duration></a></li><li><a href="#impl-Sub%3CDuration%3E-for-NaiveDateTime-1">Sub<Duration></a></li><li><a href="#impl-Sub%3CFixedOffset%3E-for-NaiveDateTime">Sub<FixedOffset></a></li><li><a href="#impl-Sub%3CMonths%3E-for-NaiveDateTime">Sub<Months></a></li><li><a href="#impl-Sub%3CNaiveDateTime%3E-for-NaiveDateTime">Sub<NaiveDateTime></a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-NaiveDateTime">SubAssign<Duration></a></li><li><a href="#impl-SubAssign%3CDuration%3E-for-NaiveDateTime-1">SubAssign<Duration></a></li><li><a href="#impl-Timelike-for-NaiveDateTime">Timelike</a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block"><li><a href="#impl-RefUnwindSafe-for-NaiveDateTime">RefUnwindSafe</a></li><li><a href="#impl-Send-for-NaiveDateTime">Send</a></li><li><a href="#impl-Sync-for-NaiveDateTime">Sync</a></li><li><a href="#impl-Unpin-for-NaiveDateTime">Unpin</a></li><li><a href="#impl-UnwindSafe-for-NaiveDateTime">UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block"><li><a href="#impl-Any-for-NaiveDateTime">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-NaiveDateTime">Borrow<T></a></li><li><a href="#impl-BorrowMut%3CT%3E-for-NaiveDateTime">BorrowMut<T></a></li><li><a href="#impl-From%3CT%3E-for-NaiveDateTime">From<T></a></li><li><a href="#impl-Into%3CU%3E-for-NaiveDateTime">Into<U></a></li><li><a href="#impl-ToOwned-for-NaiveDateTime">ToOwned</a></li><li><a href="#impl-ToString-for-NaiveDateTime">ToString</a></li><li><a href="#impl-TryFrom%3CU%3E-for-NaiveDateTime">TryFrom<U></a></li><li><a href="#impl-TryInto%3CU%3E-for-NaiveDateTime">TryInto<U></a></li></ul></section><h2><a href="index.html">In chrono::naive</a></h2></div></nav><main><div class="width-limiter"><nav class="sub"><form class="search-form"><span></span><input class="search-input" name="search" aria-label="Run search in the documentation" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><div id="help-button" title="help" tabindex="-1"><a href="../../help.html">?</a></div><div id="settings-menu" tabindex="-1"><a href="../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../static.files/wheel-7b819b6101059cd0.svg"></a></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1>Struct <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="struct" href="#">NaiveDateTime</a><button id="copy-path" title="Copy item path to clipboard"><img src="../../static.files/clipboard-7571035ce49a181d.svg" width="19" height="18" alt="Copy item path"></button></h1><span class="out-of-band"><a class="srclink" href="../../src/chrono/naive/datetime/mod.rs.html#78-81">source</a> · <button id="toggle-all-docs" title="collapse all docs">[<span>−</span>]</button></span></div><pre class="rust item-decl"><code>pub struct NaiveDateTime { /* private fields */ }</code></pre><details class="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"><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>chrono::{NaiveDate, NaiveDateTime};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>).unwrap();</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>chrono::{Datelike, Timelike, Weekday};
<span class="macro">assert_eq!</span>(dt.weekday(), Weekday::Fri);
<span class="macro">assert_eq!</span>(dt.num_seconds_from_midnight(), <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><div id="implementations-list"><details class="toggle implementors-toggle" open><summary><section id="impl-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#83-996">source</a><a href="#impl-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.new" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#101-103">source</a><h4 class="code-header">pub const fn <a href="#method.new" class="fn">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>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from 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"><a href="#example-1">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveTime, NaiveDateTime};
<span class="kw">let </span>d = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).unwrap();
<span class="kw">let </span>t = NaiveTime::from_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="kw">let </span>dt = NaiveDateTime::new(d, t);
<span class="macro">assert_eq!</span>(dt.date(), d);
<span class="macro">assert_eq!</span>(dt.time(), t);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_timestamp" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#125-128">source</a><h4 class="code-header">pub fn <a href="#method.from_timestamp" class="fn">from_timestamp</a>(secs: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a>, nsecs: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.23: use <code>from_timestamp_opt()</code> instead</span></div></span></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 a
<a href="struct.NaiveTime.html#leap-second-handling" title="struct chrono::naive::NaiveTime">leap second</a>, but only when <code>secs % 60 == 59</code>.
(The true “UNIX timestamp” cannot represent a leap second unambiguously.)</p>
<h5 id="panics"><a href="#panics">Panics</a></h5>
<p>Panics if the number of seconds would be out of range for a <code>NaiveDateTime</code> (more than
ca. 262,000 years away from common era), and panics on an invalid nanosecond (2 seconds or
more).</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_timestamp_millis" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#156-160">source</a><h4 class="code-header">pub fn <a href="#method.from_timestamp_millis" class="fn">from_timestamp_millis</a>(millis: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Creates a new <a href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a> from milliseconds since the UNIX epoch.</p>
<p>The UNIX epoch starts on midnight, January 1, 1970, UTC.</p>
<h5 id="errors"><a href="#errors">Errors</a></h5>
<p>Returns <code>None</code> if the number of milliseconds would be out of range for a <code>NaiveDateTime</code>
(more than ca. 262,000 years away from common era)</p>
<h5 id="example-2"><a href="#example-2">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDateTime;
<span class="kw">let </span>timestamp_millis: i64 = <span class="number">1662921288000</span>; <span class="comment">//Sunday, September 11, 2022 6:34:48 PM
</span><span class="kw">let </span>naive_datetime = NaiveDateTime::from_timestamp_millis(timestamp_millis);
<span class="macro">assert!</span>(naive_datetime.is_some());
<span class="macro">assert_eq!</span>(timestamp_millis, naive_datetime.unwrap().timestamp_millis());
<span class="comment">// Negative timestamps (before the UNIX epoch) are supported as well.
</span><span class="kw">let </span>timestamp_millis: i64 = -<span class="number">2208936075000</span>; <span class="comment">//Mon Jan 01 1900 14:38:45 GMT+0000
</span><span class="kw">let </span>naive_datetime = NaiveDateTime::from_timestamp_millis(timestamp_millis);
<span class="macro">assert!</span>(naive_datetime.is_some());
<span class="macro">assert_eq!</span>(timestamp_millis, naive_datetime.unwrap().timestamp_millis());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_timestamp_micros" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#188-192">source</a><h4 class="code-header">pub fn <a href="#method.from_timestamp_micros" class="fn">from_timestamp_micros</a>(micros: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Creates a new <a href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a> from microseconds since the UNIX epoch.</p>
<p>The UNIX epoch starts on midnight, January 1, 1970, UTC.</p>
<h5 id="errors-1"><a href="#errors-1">Errors</a></h5>
<p>Returns <code>None</code> if the number of microseconds would be out of range for a <code>NaiveDateTime</code>
(more than ca. 262,000 years away from common era)</p>
<h5 id="example-3"><a href="#example-3">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDateTime;
<span class="kw">let </span>timestamp_micros: i64 = <span class="number">1662921288000000</span>; <span class="comment">//Sunday, September 11, 2022 6:34:48 PM
</span><span class="kw">let </span>naive_datetime = NaiveDateTime::from_timestamp_micros(timestamp_micros);
<span class="macro">assert!</span>(naive_datetime.is_some());
<span class="macro">assert_eq!</span>(timestamp_micros, naive_datetime.unwrap().timestamp_micros());
<span class="comment">// Negative timestamps (before the UNIX epoch) are supported as well.
</span><span class="kw">let </span>timestamp_micros: i64 = -<span class="number">2208936075000000</span>; <span class="comment">//Mon Jan 01 1900 14:38:45 GMT+0000
</span><span class="kw">let </span>naive_datetime = NaiveDateTime::from_timestamp_micros(timestamp_micros);
<span class="macro">assert!</span>(naive_datetime.is_some());
<span class="macro">assert_eq!</span>(timestamp_micros, naive_datetime.unwrap().timestamp_micros());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.from_timestamp_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#226-238">source</a><h4 class="code-header">pub fn <a href="#method.from_timestamp_opt" class="fn">from_timestamp_opt</a>(secs: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a>, nsecs: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> 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 a
<a href="struct.NaiveTime.html#leap-second-handling" title="struct chrono::naive::NaiveTime">leap second</a>, but only when <code>secs % 60 == 59</code>.
(The true “UNIX timestamp” cannot represent a leap second unambiguously.)</p>
<h5 id="errors-2"><a href="#errors-2">Errors</a></h5>
<p>Returns <code>None</code> if the number of seconds would be out of range for a <code>NaiveDateTime</code> (more
than ca. 262,000 years away from common era), and panics on an invalid nanosecond
(2 seconds or more).</p>
<h5 id="example-4"><a href="#example-4">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDateTime;
<span class="kw">use </span>std::i64;
<span class="kw">let </span>from_timestamp_opt = NaiveDateTime::from_timestamp_opt;
<span class="macro">assert!</span>(from_timestamp_opt(<span class="number">0</span>, <span class="number">0</span>).is_some());
<span class="macro">assert!</span>(from_timestamp_opt(<span class="number">0</span>, <span class="number">999_999_999</span>).is_some());
<span class="macro">assert!</span>(from_timestamp_opt(<span class="number">0</span>, <span class="number">1_500_000_000</span>).is_none()); <span class="comment">// invalid leap second
</span><span class="macro">assert!</span>(from_timestamp_opt(<span class="number">59</span>, <span class="number">1_500_000_000</span>).is_some()); <span class="comment">// leap second
</span><span class="macro">assert!</span>(from_timestamp_opt(<span class="number">59</span>, <span class="number">2_000_000_000</span>).is_none());
<span class="macro">assert!</span>(from_timestamp_opt(i64::MAX, <span class="number">0</span>).is_none());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.parse_from_str" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#311-315">source</a><h4 class="code-header">pub fn <a href="#method.parse_from_str" class="fn">parse_from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>, fmt: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>) -> <a class="type" href="../format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></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-5"><a href="#example-5">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDateTime, NaiveDate};
<span class="kw">let </span>parse_from_str = NaiveDateTime::parse_from_str;
<span class="macro">assert_eq!</span>(parse_from_str(<span class="string">"2015-09-05 23:56:04"</span>, <span class="string">"%Y-%m-%d %H:%M:%S"</span>),
<span class="prelude-val">Ok</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap().and_hms_opt(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>).unwrap()));
<span class="macro">assert_eq!</span>(parse_from_str(<span class="string">"5sep2015pm012345.6789"</span>, <span class="string">"%d%b%Y%p%I%M%S%.f"</span>),
<span class="prelude-val">Ok</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap().and_hms_micro_opt(<span class="number">13</span>, <span class="number">23</span>, <span class="number">45</span>, <span class="number">678_900</span>).unwrap()));</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>(parse_from_str(<span class="string">"2014-5-17T12:34:56+09:30"</span>, <span class="string">"%Y-%m-%dT%H:%M:%S%z"</span>),
<span class="prelude-val">Ok</span>(NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">5</span>, <span class="number">17</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));</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>(parse_from_str(<span class="string">"2015-07-01 08:59:60.123"</span>, <span class="string">"%Y-%m-%d %H:%M:%S%.f"</span>),
<span class="prelude-val">Ok</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).unwrap().and_hms_milli_opt(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_123</span>).unwrap()));</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>(parse_from_str(<span class="string">"94/9/4 7:15"</span>, <span class="string">"%y/%m/%d %H:%M"</span>),
<span class="prelude-val">Ok</span>(NaiveDate::from_ymd_opt(<span class="number">1994</span>, <span class="number">9</span>, <span class="number">4</span>).unwrap().and_hms_opt(<span class="number">7</span>, <span class="number">15</span>, <span class="number">0</span>).unwrap()));
<span class="macro">assert!</span>(parse_from_str(<span class="string">"04m33s"</span>, <span class="string">"%Mm%Ss"</span>).is_err());
<span class="macro">assert!</span>(parse_from_str(<span class="string">"94/9/4 12"</span>, <span class="string">"%y/%m/%d %H"</span>).is_err());
<span class="macro">assert!</span>(parse_from_str(<span class="string">"94/9/4 17:60"</span>, <span class="string">"%y/%m/%d %H:%M"</span>).is_err());
<span class="macro">assert!</span>(parse_from_str(<span class="string">"94/9/4 24:00:00"</span>, <span class="string">"%y/%m/%d %H:%M:%S"</span>).is_err());</code></pre></div>
<p>All parsed fields should be consistent to each other, otherwise it’s an error.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>fmt = <span class="string">"%Y-%m-%d %H:%M:%S = UNIX timestamp %s"</span>;
<span class="macro">assert!</span>(parse_from_str(<span class="string">"2001-09-09 01:46:39 = UNIX timestamp 999999999"</span>, fmt).is_ok());
<span class="macro">assert!</span>(parse_from_str(<span class="string">"1970-01-01 00:00:00 = UNIX timestamp 1"</span>, fmt).is_err());</code></pre></div>
<p>Years before 1 BCE or after 9999 CE, require an initial sign</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code> <span class="kw">let </span>fmt = <span class="string">"%Y-%m-%d %H:%M:%S"</span>;
<span class="macro">assert!</span>(parse_from_str(<span class="string">"10000-09-09 01:46:39"</span>, fmt).is_err());
<span class="macro">assert!</span>(parse_from_str(<span class="string">"+10000-09-09 01:46:39"</span>, fmt).is_ok());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.parse_and_remainder" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#336-340">source</a><h4 class="code-header">pub fn <a href="#method.parse_and_remainder" class="fn">parse_and_remainder</a><'a>(
s: &'a <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>,
fmt: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>
) -> <a class="type" href="../format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><(<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>, &'a <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>)></h4></section></summary><div class="docblock"><p>Parses a string with the specified format string and returns a new <code>NaiveDateTime</code>, and a
slice with the remaining portion of the string.
See the <a href="../format/strftime/index.html"><code>format::strftime</code> module</a>
on the supported escape sequences.</p>
<p>Similar to <a href="#method.parse_from_str"><code>parse_from_str</code></a>.</p>
<h5 id="example-6"><a href="#example-6">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>(datetime, remainder) = NaiveDateTime::parse_and_remainder(
<span class="string">"2015-02-18 23:16:09 trailing text"</span>, <span class="string">"%Y-%m-%d %H:%M:%S"</span>).unwrap();
<span class="macro">assert_eq!</span>(
datetime,
NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">2</span>, <span class="number">18</span>).unwrap().and_hms_opt(<span class="number">23</span>, <span class="number">16</span>, <span class="number">9</span>).unwrap()
);
<span class="macro">assert_eq!</span>(remainder, <span class="string">" trailing text"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.date" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#353-355">source</a><h4 class="code-header">pub const fn <a href="#method.date" class="fn">date</a>(&self) -> <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h4></section></summary><div class="docblock"><p>Retrieves a date component.</p>
<h5 id="example-7"><a href="#example-7">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.date(), NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).unwrap());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.time" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#368-370">source</a><h4 class="code-header">pub const fn <a href="#method.time" class="fn">time</a>(&self) -> <a class="struct" href="struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></h4></section></summary><div class="docblock"><p>Retrieves a time component.</p>
<h5 id="example-8"><a href="#example-8">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveTime};
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.time(), NaiveTime::from_hms_opt(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>).unwrap());</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.timestamp" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#396-401">source</a><h4 class="code-header">pub fn <a href="#method.timestamp" class="fn">timestamp</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a></h4></section></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-9"><a href="#example-9">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_milli_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">980</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp(), <span class="number">1</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp(), <span class="number">1_000_000_000</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">1969</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap().and_hms_opt(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp(), -<span class="number">1</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(-<span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp(), -<span class="number">62198755200</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.timestamp_millis" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#424-427">source</a><h4 class="code-header">pub fn <a href="#method.timestamp_millis" class="fn">timestamp_millis</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a></h4></section></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>
<h5 id="example-10"><a href="#example-10">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_milli_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">444</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_millis(), <span class="number">1_444</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).unwrap().and_hms_milli_opt(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>, <span class="number">555</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_millis(), <span class="number">1_000_000_000_555</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">1969</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap().and_hms_milli_opt(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">100</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_millis(), -<span class="number">900</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.timestamp_micros" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#447-450">source</a><h4 class="code-header">pub fn <a href="#method.timestamp_micros" class="fn">timestamp_micros</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a></h4></section></summary><div class="docblock"><p>Returns the number of non-leap <em>microseconds</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="example-11"><a href="#example-11">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_micro_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">444</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_micros(), <span class="number">1_000_444</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).unwrap().and_hms_micro_opt(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>, <span class="number">555</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_micros(), <span class="number">1_000_000_000_000_555</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.timestamp_nanos" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#467-470">source</a><h4 class="code-header">pub fn <a href="#method.timestamp_nanos" class="fn">timestamp_nanos</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a></h4></section><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.31: use <code>timestamp_nanos_opt()</code> instead</span></div></span></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-1"><a href="#panics-1">Panics</a></h5>
<p>An <code>i64</code> with nanosecond precision can span a range of ~584 years. This function panics on
an out of range <code>NaiveDateTime</code>.</p>
<p>The dates that can be represented as nanoseconds are between 1677-09-21T00:12:44.0 and
2262-04-11T23:47:16.854775804.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.timestamp_nanos_opt" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#505-526">source</a><h4 class="code-header">pub fn <a href="#method.timestamp_nanos_opt" class="fn">timestamp_nanos_opt</a>(&self) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i64.html">i64</a>></h4></section></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="errors-3"><a href="#errors-3">Errors</a></h5>
<p>An <code>i64</code> with nanosecond precision can span a range of ~584 years. This function returns
<code>None</code> on an out of range <code>NaiveDateTime</code>.</p>
<p>The dates that can be represented as nanoseconds are between 1677-09-21T00:12:44.0 and
2262-04-11T23:47:16.854775804.</p>
<h5 id="example-12"><a href="#example-12">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime};
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_nano_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">444</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_nanos_opt(), <span class="prelude-val">Some</span>(<span class="number">1_000_000_444</span>));
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).unwrap().and_hms_nano_opt(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>, <span class="number">555</span>).unwrap();
<span class="kw">const </span>A_BILLION: i64 = <span class="number">1_000_000_000</span>;
<span class="kw">let </span>nanos = dt.timestamp_nanos_opt().unwrap();
<span class="macro">assert_eq!</span>(nanos, <span class="number">1_000_000_000_000_000_555</span>);
<span class="macro">assert_eq!</span>(
<span class="prelude-val">Some</span>(dt),
NaiveDateTime::from_timestamp_opt(nanos / A_BILLION, (nanos % A_BILLION) <span class="kw">as </span>u32)
);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.timestamp_subsec_millis" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#546-548">source</a><h4 class="code-header">pub fn <a href="#method.timestamp_subsec_millis" class="fn">timestamp_subsec_millis</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the 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-13"><a href="#example-13">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).unwrap().and_hms_nano_opt(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_subsec_millis(), <span class="number">123</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).unwrap().and_hms_nano_opt(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_subsec_millis(), <span class="number">1_234</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.timestamp_subsec_micros" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#568-570">source</a><h4 class="code-header">pub fn <a href="#method.timestamp_subsec_micros" class="fn">timestamp_subsec_micros</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the 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-14"><a href="#example-14">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).unwrap().and_hms_nano_opt(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_subsec_micros(), <span class="number">123_456</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).unwrap().and_hms_nano_opt(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_subsec_micros(), <span class="number">1_234_567</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.timestamp_subsec_nanos" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#590-592">source</a><h4 class="code-header">pub fn <a href="#method.timestamp_subsec_nanos" class="fn">timestamp_subsec_nanos</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the 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-15"><a href="#example-15">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).unwrap().and_hms_nano_opt(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_subsec_nanos(), <span class="number">123_456_789</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).unwrap().and_hms_nano_opt(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.timestamp_subsec_nanos(), <span class="number">1_234_567_890</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_add_signed" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#662-672">source</a><h4 class="code-header">pub fn <a href="#method.checked_add_signed" class="fn">checked_add_signed</a>(self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></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>
<h5 id="errors-4"><a href="#errors-4">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-16"><a href="#example-16">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="kw">let </span>d = from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="kw">let </span>hms = |h, m, s| d.and_hms_opt(h, m, s).unwrap();
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_add_signed(Duration::zero()),
<span class="prelude-val">Some</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_add_signed(Duration::seconds(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>)));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_add_signed(Duration::seconds(-<span class="number">1</span>)),
<span class="prelude-val">Some</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>)));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_add_signed(Duration::seconds(<span class="number">3600 </span>+ <span class="number">60</span>)),
<span class="prelude-val">Some</span>(hms(<span class="number">4</span>, <span class="number">6</span>, <span class="number">7</span>)));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_add_signed(Duration::seconds(<span class="number">86_400</span>)),
<span class="prelude-val">Some</span>(from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).and_hms_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).unwrap()));
<span class="kw">let </span>hmsm = |h, m, s, milli| d.and_hms_milli_opt(h, m, s, milli).unwrap();
<span class="macro">assert_eq!</span>(hmsm(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">980</span>).checked_add_signed(Duration::milliseconds(<span class="number">450</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_add_signed(Duration::days(<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>leap = hmsm(<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>(leap.checked_add_signed(Duration::zero()),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_add_signed(Duration::milliseconds(-<span class="number">500</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_add_signed(Duration::milliseconds(<span class="number">500</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_add_signed(Duration::milliseconds(<span class="number">800</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_add_signed(Duration::seconds(<span class="number">10</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_add_signed(Duration::seconds(-<span class="number">10</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_add_signed(Duration::days(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).and_hms_milli_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">300</span>).unwrap()));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_add_months" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#700-702">source</a><h4 class="code-header">pub fn <a href="#method.checked_add_months" class="fn">checked_add_months</a>(self, rhs: <a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Adds given <code>Months</code> to the current date and time.</p>
<p>Uses the last day of the month if the day does not exist in the resulting month.</p>
<h5 id="errors-5"><a href="#errors-5">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-17"><a href="#example-17">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Months, NaiveDate};
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap()
.checked_add_months(Months::new(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">2</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap())
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap()
.checked_add_months(Months::new(core::i32::MAX <span class="kw">as </span>u32 + <span class="number">1</span>)),
<span class="prelude-val">None
</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_sub_signed" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#768-778">source</a><h4 class="code-header">pub fn <a href="#method.checked_sub_signed" class="fn">checked_sub_signed</a>(self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></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>
<h5 id="errors-6"><a href="#errors-6">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-18"><a href="#example-18">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="kw">let </span>d = from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="kw">let </span>hms = |h, m, s| d.and_hms_opt(h, m, s).unwrap();
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_sub_signed(Duration::zero()),
<span class="prelude-val">Some</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_sub_signed(Duration::seconds(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>)));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_sub_signed(Duration::seconds(-<span class="number">1</span>)),
<span class="prelude-val">Some</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>)));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_sub_signed(Duration::seconds(<span class="number">3600 </span>+ <span class="number">60</span>)),
<span class="prelude-val">Some</span>(hms(<span class="number">2</span>, <span class="number">4</span>, <span class="number">7</span>)));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_sub_signed(Duration::seconds(<span class="number">86_400</span>)),
<span class="prelude-val">Some</span>(from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).and_hms_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).unwrap()));
<span class="kw">let </span>hmsm = |h, m, s, milli| d.and_hms_milli_opt(h, m, s, milli).unwrap();
<span class="macro">assert_eq!</span>(hmsm(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">450</span>).checked_sub_signed(Duration::milliseconds(<span class="number">670</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).checked_sub_signed(Duration::days(<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>leap = hmsm(<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>(leap.checked_sub_signed(Duration::zero()),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_sub_signed(Duration::milliseconds(<span class="number">200</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_sub_signed(Duration::milliseconds(<span class="number">500</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_sub_signed(Duration::seconds(<span class="number">60</span>)),
<span class="prelude-val">Some</span>(hmsm(<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>(leap.checked_sub_signed(Duration::days(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).and_hms_milli_opt(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">300</span>).unwrap()));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_sub_months" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#806-808">source</a><h4 class="code-header">pub fn <a href="#method.checked_sub_months" class="fn">checked_sub_months</a>(self, rhs: <a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Subtracts given <code>Months</code> from the current date and time.</p>
<p>Uses the last day of the month if the day does not exist in the resulting month.</p>
<h5 id="errors-7"><a href="#errors-7">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
<h5 id="example-19"><a href="#example-19">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Months, NaiveDate};
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap()
.checked_sub_months(Months::new(<span class="number">1</span>)),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap())
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap()
.checked_sub_months(Months::new(core::i32::MAX <span class="kw">as </span>u32 + <span class="number">1</span>)),
<span class="prelude-val">None
</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_add_days" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#814-816">source</a><h4 class="code-header">pub fn <a href="#method.checked_add_days" class="fn">checked_add_days</a>(self, days: <a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><Self></h4></section></summary><div class="docblock"><p>Add a duration in <a href="struct.Days.html" title="struct chrono::naive::Days"><code>Days</code></a> to the date part of the <code>NaiveDateTime</code></p>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.checked_sub_days" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#822-824">source</a><h4 class="code-header">pub fn <a href="#method.checked_sub_days" class="fn">checked_sub_days</a>(self, days: <a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><Self></h4></section></summary><div class="docblock"><p>Subtract a duration in <a href="struct.Days.html" title="struct chrono::naive::Days"><code>Days</code></a> from the date part of the <code>NaiveDateTime</code></p>
<p>Returns <code>None</code> if the resulting date would be out of range.</p>
</div></details><details class="toggle method-toggle" open><summary><section id="method.signed_duration_since" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#865-867">source</a><h4 class="code-header">pub fn <a href="#method.signed_duration_since" class="fn">signed_duration_since</a>(self, rhs: <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a></h4></section></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-20"><a href="#example-20">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="kw">let </span>d = from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="macro">assert_eq!</span>(d.and_hms_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).unwrap().signed_duration_since(d.and_hms_opt(<span class="number">2</span>, <span class="number">4</span>, <span class="number">6</span>).unwrap()),
Duration::seconds(<span class="number">3600 </span>+ <span class="number">60 </span>+ <span class="number">1</span>));
<span class="comment">// July 8 is 190th day in the year 2016
</span><span class="kw">let </span>d0 = from_ymd(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>);
<span class="macro">assert_eq!</span>(d.and_hms_milli_opt(<span class="number">0</span>, <span class="number">7</span>, <span class="number">6</span>, <span class="number">500</span>).unwrap().signed_duration_since(d0.and_hms_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap()),
Duration::seconds(<span class="number">189 </span>* <span class="number">86_400 </span>+ <span class="number">7 </span>* <span class="number">60 </span>+ <span class="number">6</span>) + Duration::milliseconds(<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>leap = from_ymd(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).and_hms_milli_opt(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>).unwrap();
<span class="macro">assert_eq!</span>(leap.signed_duration_since(from_ymd(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).and_hms_opt(<span class="number">23</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap()),
Duration::seconds(<span class="number">3600</span>) + Duration::milliseconds(<span class="number">500</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap().signed_duration_since(leap),
Duration::seconds(<span class="number">3600</span>) - Duration::milliseconds(<span class="number">500</span>));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.format_with_items" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#900-906">source</a><h4 class="code-header">pub fn <a href="#method.format_with_items" class="fn">format_with_items</a><'a, I, B>(&self, items: I) -> <a class="struct" href="../format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><I><span class="where fmt-newline">where
I: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/iter/traits/iterator/trait.Iterator.html" title="trait core::iter::traits::iterator::Iterator">Iterator</a><Item = B> + <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,
B: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><<a class="enum" href="../format/enum.Item.html" title="enum chrono::format::Item">Item</a><'a>>,</span></h4></section></summary><div class="docblock"><p>Formats the 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-21"><a href="#example-21">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">use </span>chrono::format::strftime::StrftimeItems;
<span class="kw">let </span>fmt = StrftimeItems::new(<span class="string">"%Y-%m-%d %H:%M:%S"</span>);
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap().and_hms_opt(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.format_with_items(fmt.clone()).to_string(), <span class="string">"2015-09-05 23:56:04"</span>);
<span class="macro">assert_eq!</span>(dt.format(<span class="string">"%Y-%m-%d %H:%M:%S"</span>).to_string(), <span class="string">"2015-09-05 23:56:04"</span>);</code></pre></div>
<p>The resulting <code>DelayedFormat</code> can be formatted directly via the <code>Display</code> trait.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, dt.format_with_items(fmt)), <span class="string">"2015-09-05 23:56:04"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.format" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#944-946">source</a><h4 class="code-header">pub fn <a href="#method.format" class="fn">format</a><'a>(&self, fmt: &'a <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>) -> <a class="struct" href="../format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><<a class="struct" href="../format/strftime/struct.StrftimeItems.html" title="struct chrono::format::strftime::StrftimeItems">StrftimeItems</a><'a>></h4></section></summary><div class="docblock"><p>Formats the 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-22"><a href="#example-22">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap().and_hms_opt(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.format(<span class="string">"%Y-%m-%d %H:%M:%S"</span>).to_string(), <span class="string">"2015-09-05 23:56:04"</span>);
<span class="macro">assert_eq!</span>(dt.format(<span class="string">"around %l %p on %b %-d"</span>).to_string(), <span class="string">"around 11 PM on Sep 5"</span>);</code></pre></div>
<p>The resulting <code>DelayedFormat</code> can be formatted directly via the <code>Display</code> trait.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, dt.format(<span class="string">"%Y-%m-%d %H:%M:%S"</span>)), <span class="string">"2015-09-05 23:56:04"</span>);
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, dt.format(<span class="string">"around %l %p on %b %-d"</span>)), <span class="string">"around 11 PM on Sep 5"</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_local_timezone" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#969-971">source</a><h4 class="code-header">pub fn <a href="#method.and_local_timezone" class="fn">and_local_timezone</a><Tz: <a class="trait" href="../offset/trait.TimeZone.html" title="trait chrono::offset::TimeZone">TimeZone</a>>(
&self,
tz: Tz
) -> <a class="enum" href="../offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a><<a class="struct" href="../struct.DateTime.html" title="struct chrono::DateTime">DateTime</a><Tz>></h4></section></summary><div class="docblock"><p>Converts the <code>NaiveDateTime</code> into the timezone-aware <code>DateTime<Tz></code>
with the provided timezone, if possible.</p>
<p>This can fail in cases where the local time represented by the <code>NaiveDateTime</code>
is not a valid local timestamp in the target timezone due to an offset transition
for example if the target timezone had a change from +00:00 to +01:00
occuring at 2015-09-05 22:59:59, then a local time of 2015-09-05 23:56:04
could never occur. Similarly, if the offset transitioned in the opposite direction
then there would be two local times of 2015-09-05 23:56:04, one at +00:00 and one
at +01:00.</p>
<h5 id="example-23"><a href="#example-23">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, FixedOffset};
<span class="kw">let </span>hour = <span class="number">3600</span>;
<span class="kw">let </span>tz = FixedOffset::east_opt(<span class="number">5 </span>* hour).unwrap();
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).unwrap().and_hms_opt(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>).unwrap().and_local_timezone(tz).unwrap();
<span class="macro">assert_eq!</span>(dt.timezone(), tz);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.and_utc" class="method"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#983-985">source</a><h4 class="code-header">pub fn <a href="#method.and_utc" class="fn">and_utc</a>(&self) -> <a class="struct" href="../struct.DateTime.html" title="struct chrono::DateTime">DateTime</a><<a class="struct" href="../offset/struct.Utc.html" title="struct chrono::offset::Utc">Utc</a>></h4></section></summary><div class="docblock"><p>Converts the <code>NaiveDateTime</code> into the timezone-aware <code>DateTime<Utc></code>.</p>
<h5 id="example-24"><a href="#example-24">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, Utc};
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2023</span>, <span class="number">1</span>, <span class="number">30</span>).unwrap().and_hms_opt(<span class="number">19</span>, <span class="number">32</span>, <span class="number">33</span>).unwrap().and_utc();
<span class="macro">assert_eq!</span>(dt.timezone(), Utc);</code></pre></div>
</div></details><details class="toggle" open><summary><section id="associatedconstant.MIN" class="associatedconstant"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#988">source</a><h4 class="code-header">pub const <a href="#associatedconstant.MIN" class="constant">MIN</a>: Self = _</h4></section></summary><div class="docblock"><p>The minimum possible <code>NaiveDateTime</code>.</p>
</div></details><details class="toggle" open><summary><section id="associatedconstant.MAX" class="associatedconstant"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#991">source</a><h4 class="code-header">pub const <a href="#associatedconstant.MAX" class="constant">MAX</a>: Self = _</h4></section></summary><div class="docblock"><p>The maximum possible <code>NaiveDateTime</code>.</p>
</div></details><details class="toggle" open><summary><section id="associatedconstant.UNIX_EPOCH" class="associatedconstant"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#994-995">source</a><h4 class="code-header">pub const <a href="#associatedconstant.UNIX_EPOCH" class="constant">UNIX_EPOCH</a>: Self = _</h4></section></summary><div class="docblock"><p>The Unix Epoch, 1970-01-01 00:00:00.</p>
</div></details></div></details></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor">§</a></h2><div id="trait-implementations-list"><details class="toggle implementors-toggle" open><summary><section id="impl-Add%3CDays%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1794-1800">source</a><a href="#impl-Add%3CDays%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-2" class="associatedtype trait-impl"><a href="#associatedtype.Output-2" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.add-1" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1797-1799">source</a><a href="#method.add-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add" class="fn">add</a>(self, days: <a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>) -> Self::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" title="type core::ops::arith::Add::Output">Output</a></h4></section></summary><div class='docblock'>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Add%3CDuration%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1562-1571">source</a><a href="#impl-Add%3CDuration%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="https://doc.rust-lang.org/1.69.0/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-7" class="associatedtype trait-impl"><a href="#associatedtype.Output-7" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.add-3" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1566-1570">source</a><a href="#method.add-3" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add" class="fn">add</a>(self, rhs: <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Add%3CDuration%3E-for-NaiveDateTime-1" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1553-1560">source</a><a href="#impl-Add%3CDuration%3E-for-NaiveDateTime-1" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></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" title="struct chrono::naive::NaiveTime">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>
<h4 id="panics-4"><a href="#panics-4">Panics</a></h4>
<p>Panics if the resulting date would be out of range. Use <a href="struct.NaiveDateTime.html#method.checked_add_signed" title="method chrono::naive::NaiveDateTime::checked_add_signed"><code>NaiveDateTime::checked_add_signed</code></a>
to detect that.</p>
<h4 id="example-55"><a href="#example-55">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="kw">let </span>d = from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="kw">let </span>hms = |h, m, s| d.and_hms_opt(h, m, s).unwrap();
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) + Duration::zero(), hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) + Duration::seconds(<span class="number">1</span>), hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) + Duration::seconds(-<span class="number">1</span>), hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) + Duration::seconds(<span class="number">3600 </span>+ <span class="number">60</span>), hms(<span class="number">4</span>, <span class="number">6</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) + Duration::seconds(<span class="number">86_400</span>),
from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).and_hms_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).unwrap());
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) + Duration::days(<span class="number">365</span>),
from_ymd(<span class="number">2017</span>, <span class="number">7</span>, <span class="number">8</span>).and_hms_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).unwrap());
<span class="kw">let </span>hmsm = |h, m, s, milli| d.and_hms_milli_opt(h, m, s, milli).unwrap();
<span class="macro">assert_eq!</span>(hmsm(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">980</span>) + Duration::milliseconds(<span class="number">450</span>), hmsm(<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>leap = hmsm(<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>(leap + Duration::zero(), hmsm(<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>(leap + Duration::milliseconds(-<span class="number">500</span>), hmsm(<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>(leap + Duration::milliseconds(<span class="number">500</span>), hmsm(<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>(leap + Duration::milliseconds(<span class="number">800</span>), hmsm(<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>(leap + Duration::seconds(<span class="number">10</span>), hmsm(<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>(leap + Duration::seconds(-<span class="number">10</span>), hmsm(<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>(leap + Duration::days(<span class="number">1</span>),
from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).and_hms_milli_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">300</span>).unwrap());</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-9" class="associatedtype trait-impl"><a href="#associatedtype.Output-9" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.add-4" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1557-1559">source</a><a href="#method.add-4" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add" class="fn">add</a>(self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Add%3CFixedOffset%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/offset/fixed.rs.html#219-226">source</a><a href="#impl-Add%3CFixedOffset%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-5" class="associatedtype trait-impl"><a href="#associatedtype.Output-5" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.add-2" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/offset/fixed.rs.html#223-225">source</a><a href="#method.add-2" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add" class="fn">add</a>(self, rhs: <a class="struct" href="../offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Add%3CMonths%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1587-1629">source</a><a href="#impl-Add%3CMonths%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.add" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1626-1628">source</a><a href="#method.add" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#tymethod.add" class="fn">add</a>(self, rhs: <a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>) -> Self::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" title="type core::ops::arith::Add::Output">Output</a></h4></section></summary><div class="docblock"><p>An addition of months to <code>NaiveDateTime</code> clamped to valid days in resulting month.</p>
<h5 id="panics-3"><a href="#panics-3">Panics</a></h5>
<p>Panics if the resulting date would be out of range.</p>
<h5 id="example-26"><a href="#example-26">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Months, NaiveDate};
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap() + Months::new(<span class="number">1</span>),
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">2</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap()
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">2</span>, <span class="number">0</span>).unwrap() + Months::new(<span class="number">11</span>),
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">2</span>, <span class="number">0</span>).unwrap()
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">3</span>).unwrap() + Months::new(<span class="number">12</span>),
NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">3</span>).unwrap()
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">4</span>).unwrap() + Months::new(<span class="number">13</span>),
NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">2</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">4</span>).unwrap()
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">31</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">5</span>, <span class="number">0</span>).unwrap() + Months::new(<span class="number">1</span>),
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">2</span>, <span class="number">28</span>).unwrap().and_hms_opt(<span class="number">0</span>, <span class="number">5</span>, <span class="number">0</span>).unwrap()
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2020</span>, <span class="number">1</span>, <span class="number">31</span>).unwrap().and_hms_opt(<span class="number">6</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap() + Months::new(<span class="number">1</span>),
NaiveDate::from_ymd_opt(<span class="number">2020</span>, <span class="number">2</span>, <span class="number">29</span>).unwrap().and_hms_opt(<span class="number">6</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap()
);</code></pre></div>
</div></details><details class="toggle" open><summary><section id="associatedtype.Output-1" class="associatedtype trait-impl"><a href="#associatedtype.Output-1" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Add.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>+</code> operator.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-AddAssign%3CDuration%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1573-1578">source</a><a href="#impl-AddAssign%3CDuration%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html" title="trait core::ops::arith::AddAssign">AddAssign</a><<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.add_assign" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1575-1577">source</a><a href="#method.add_assign" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html#tymethod.add_assign" class="fn">add_assign</a>(&mut self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</h4></section></summary><div class='docblock'>Performs the <code>+=</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html#tymethod.add_assign">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-AddAssign%3CDuration%3E-for-NaiveDateTime-1" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1580-1585">source</a><a href="#impl-AddAssign%3CDuration%3E-for-NaiveDateTime-1" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html" title="trait core::ops::arith::AddAssign">AddAssign</a><<a class="struct" href="https://doc.rust-lang.org/1.69.0/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.add_assign-1" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1582-1584">source</a><a href="#method.add_assign-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html#tymethod.add_assign" class="fn">add_assign</a>(&mut self, rhs: <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>)</h4></section></summary><div class='docblock'>Performs the <code>+=</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.AddAssign.html#tymethod.add_assign">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Clone-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-Clone-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.clone" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#method.clone" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html#tymethod.clone" class="fn">clone</a>(&self) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>Returns a copy of the value. <a href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html#tymethod.clone">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clone_from" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/clone.rs.html#132-134">source</a></span><a href="#method.clone_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html#method.clone_from" class="fn">clone_from</a>(&mut self, source: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Self</a>)</h4></section></summary><div class='docblock'>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html#method.clone_from">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Datelike-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#998-1326">source</a><a href="#impl-Datelike-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="../trait.Datelike.html" title="trait chrono::Datelike">Datelike</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.year" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1012-1014">source</a><a href="#method.year" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.year" class="fn">year</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a></h4></section></summary><div class="docblock"><p>Returns the year number in the <a href="./struct.NaiveDate.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-40"><a href="#example-40">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.year(), <span class="number">2015</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.month" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1031-1033">source</a><a href="#method.month" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.month" class="fn">month</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the month number starting from 1.</p>
<p>The return value ranges from 1 to 12.</p>
<p>See also the <a href="./struct.NaiveDate.html#method.month"><code>NaiveDate::month</code></a> method.</p>
<h5 id="example-41"><a href="#example-41">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.month(), <span class="number">9</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.month0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1050-1052">source</a><a href="#method.month0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.month0" class="fn">month0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the month number starting from 0.</p>
<p>The return value ranges from 0 to 11.</p>
<p>See also the <a href="./struct.NaiveDate.html#method.month0"><code>NaiveDate::month0</code></a> method.</p>
<h5 id="example-42"><a href="#example-42">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.month0(), <span class="number">8</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.day" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1069-1071">source</a><a href="#method.day" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.day" class="fn">day</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the day of month starting from 1.</p>
<p>The return value ranges from 1 to 31. (The last day of month differs by months.)</p>
<p>See also the <a href="./struct.NaiveDate.html#method.day"><code>NaiveDate::day</code></a> method.</p>
<h5 id="example-43"><a href="#example-43">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.day(), <span class="number">25</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.day0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1088-1090">source</a><a href="#method.day0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.day0" class="fn">day0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the day of month starting from 0.</p>
<p>The return value ranges from 0 to 30. (The last day of month differs by months.)</p>
<p>See also the <a href="./struct.NaiveDate.html#method.day0"><code>NaiveDate::day0</code></a> method.</p>
<h5 id="example-44"><a href="#example-44">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.day0(), <span class="number">24</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.ordinal" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1107-1109">source</a><a href="#method.ordinal" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.ordinal" class="fn">ordinal</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the day of year starting from 1.</p>
<p>The return value ranges from 1 to 366. (The last day of year differs by years.)</p>
<p>See also the <a href="./struct.NaiveDate.html#method.ordinal"><code>NaiveDate::ordinal</code></a> method.</p>
<h5 id="example-45"><a href="#example-45">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.ordinal(), <span class="number">268</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.ordinal0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1126-1128">source</a><a href="#method.ordinal0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.ordinal0" class="fn">ordinal0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the day of year starting from 0.</p>
<p>The return value ranges from 0 to 365. (The last day of year differs by years.)</p>
<p>See also the <a href="./struct.NaiveDate.html#method.ordinal0"><code>NaiveDate::ordinal0</code></a> method.</p>
<h5 id="example-46"><a href="#example-46">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.ordinal0(), <span class="number">267</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.weekday" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1143-1145">source</a><a href="#method.weekday" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.weekday" class="fn">weekday</a>(&self) -> <a class="enum" href="../enum.Weekday.html" title="enum chrono::Weekday">Weekday</a></h4></section></summary><div class="docblock"><p>Returns the day of week.</p>
<p>See also the <a href="./struct.NaiveDate.html#method.weekday"><code>NaiveDate::weekday</code></a> method.</p>
<h5 id="example-47"><a href="#example-47">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike, Weekday};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.weekday(), Weekday::Fri);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_year" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1172-1174">source</a><a href="#method.with_year" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_year" class="fn">with_year</a>(&self, year: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the year number changed, while keeping the same month and
day.</p>
<p>See also the <a href="struct.NaiveDate.html#method.with_year" title="method chrono::naive::NaiveDate::with_year"><code>NaiveDate::with_year</code></a> method.</p>
<h5 id="errors-12"><a href="#errors-12">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or when the <code>NaiveDateTime</code> would be
out of range.</p>
<h5 id="example-48"><a href="#example-48">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_year(<span class="number">2016</span>), <span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_year(-<span class="number">308</span>), <span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(-<span class="number">308</span>, <span class="number">9</span>, <span class="number">25</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_month" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1195-1197">source</a><a href="#method.with_month" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_month" class="fn">with_month</a>(&self, month: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the month number (starting from 1) changed.</p>
<p>See also the <a href="struct.NaiveDate.html#method.with_month" title="method chrono::naive::NaiveDate::with_month"><code>NaiveDate::with_month</code></a> method.</p>
<h5 id="errors-13"><a href="#errors-13">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>month</code> is invalid.</p>
<h5 id="example-49"><a href="#example-49">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_month(<span class="number">10</span>), <span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">30</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_month(<span class="number">13</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13
</span><span class="macro">assert_eq!</span>(dt.with_month(<span class="number">2</span>), <span class="prelude-val">None</span>); <span class="comment">// no February 30</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_month0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1219-1221">source</a><a href="#method.with_month0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_month0" class="fn">with_month0</a>(&self, month0: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the month number (starting from 0) changed.</p>
<p>See also the <a href="struct.NaiveDate.html#method.with_month0" title="method chrono::naive::NaiveDate::with_month0"><code>NaiveDate::with_month0</code></a> method.</p>
<h5 id="errors-14"><a href="#errors-14">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>month0</code> is
invalid.</p>
<h5 id="example-50"><a href="#example-50">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_month0(<span class="number">9</span>), <span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">30</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_month0(<span class="number">12</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13
</span><span class="macro">assert_eq!</span>(dt.with_month0(<span class="number">1</span>), <span class="prelude-val">None</span>); <span class="comment">// no February 30</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_day" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1241-1243">source</a><a href="#method.with_day" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_day" class="fn">with_day</a>(&self, day: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of month (starting from 1) changed.</p>
<p>See also the <a href="struct.NaiveDate.html#method.with_day" title="method chrono::naive::NaiveDate::with_day"><code>NaiveDate::with_day</code></a> method.</p>
<h5 id="errors-15"><a href="#errors-15">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>day</code> is invalid.</p>
<h5 id="example-51"><a href="#example-51">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_day(<span class="number">30</span>), <span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_day(<span class="number">31</span>), <span class="prelude-val">None</span>); <span class="comment">// no September 31</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_day0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1263-1265">source</a><a href="#method.with_day0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_day0" class="fn">with_day0</a>(&self, day0: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of month (starting from 0) changed.</p>
<p>See also the <a href="struct.NaiveDate.html#method.with_day0" title="method chrono::naive::NaiveDate::with_day0"><code>NaiveDate::with_day0</code></a> method.</p>
<h5 id="errors-16"><a href="#errors-16">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>day0</code> is invalid.</p>
<h5 id="example-52"><a href="#example-52">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_day0(<span class="number">29</span>), <span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_day0(<span class="number">30</span>), <span class="prelude-val">None</span>); <span class="comment">// no September 31</span></code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_ordinal" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1293-1295">source</a><a href="#method.with_ordinal" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_ordinal" class="fn">with_ordinal</a>(&self, ordinal: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of year (starting from 1) changed.</p>
<p>See also the <a href="struct.NaiveDate.html#method.with_ordinal" title="method chrono::naive::NaiveDate::with_ordinal"><code>NaiveDate::with_ordinal</code></a> method.</p>
<h5 id="errors-17"><a href="#errors-17">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>ordinal</code> is
invalid.</p>
<h5 id="example-53"><a href="#example-53">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_ordinal(<span class="number">60</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_ordinal(<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>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_ordinal(<span class="number">60</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_ordinal(<span class="number">366</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_ordinal0" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1323-1325">source</a><a href="#method.with_ordinal0" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.with_ordinal0" class="fn">with_ordinal0</a>(&self, ordinal0: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of year (starting from 0) changed.</p>
<p>See also the <a href="struct.NaiveDate.html#method.with_ordinal0" title="method chrono::naive::NaiveDate::with_ordinal0"><code>NaiveDate::with_ordinal0</code></a> method.</p>
<h5 id="errors-18"><a href="#errors-18">Errors</a></h5>
<p>Returns <code>None</code> if the resulting date does not exist, or if the value for <code>ordinal0</code> is
invalid.</p>
<h5 id="example-54"><a href="#example-54">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Datelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_ordinal0(<span class="number">59</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_ordinal0(<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>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_ordinal0(<span class="number">59</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_ordinal0(<span class="number">365</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>).unwrap().and_hms_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).unwrap()));</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.iso_week" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1148-1150">source</a><a href="#method.iso_week" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#tymethod.iso_week" class="fn">iso_week</a>(&self) -> <a class="struct" href="struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></h4></section></summary><div class='docblock'>Returns the ISO week.</div></details><details class="toggle method-toggle" open><summary><section id="method.year_ce" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/traits.rs.html#38-45">source</a><a href="#method.year_ce" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#method.year_ce" class="fn">year_ce</a>(&self) -> (<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a>, <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>)</h4></section></summary><div class='docblock'>Returns the absolute year number starting from 1 with a boolean flag,
which is false when the year predates the epoch (BCE/BC) and true otherwise (CE/AD).</div></details><details class="toggle method-toggle" open><summary><section id="method.num_days_from_ce" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/traits.rs.html#248-263">source</a><a href="#method.num_days_from_ce" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Datelike.html#method.num_days_from_ce" class="fn">num_days_from_ce</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.i32.html">i32</a></h4></section></summary><div class='docblock'>Counts the days in the proleptic Gregorian calendar, with January 1, Year 1 (CE) as day 1. <a href="../trait.Datelike.html#method.num_days_from_ce">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Debug-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1837-1843">source</a><a href="#impl-Debug-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></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" title="mod chrono::format::strftime"><code>dt.format("%Y-%m-%dT%H:%M:%S%.f")</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-56"><a href="#example-56">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">11</span>, <span class="number">15</span>).unwrap().and_hms_opt(<span class="number">7</span>, <span class="number">39</span>, <span class="number">24</span>).unwrap();
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, dt), <span class="string">"2016-11-15T07:39:24"</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>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).unwrap().and_hms_milli_opt(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>).unwrap();
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{:?}"</span>, dt), <span class="string">"2015-06-30T23:59:60.500"</span>);</code></pre></div>
</div><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.fmt-1" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1838-1842">source</a><a href="#method.fmt-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Debug.html#tymethod.fmt" class="fn">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/1.69.0/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Default-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1936-1940">source</a><a href="#impl-Default-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/default/trait.Default.html" title="trait core::default::Default">Default</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="docblock"><p>The default value for a NaiveDateTime is one with epoch 0
that is, 1st of January 1970 at 00:00:00.</p>
<h4 id="example-37"><a href="#example-37">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDateTime;
<span class="kw">let </span>default_date = NaiveDateTime::default();
<span class="macro">assert_eq!</span>(<span class="prelude-val">Some</span>(default_date), NaiveDateTime::from_timestamp_opt(<span class="number">0</span>, <span class="number">0</span>));</code></pre></div>
</div><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.default" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1937-1939">source</a><a href="#method.default" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/default/trait.Default.html#tymethod.default" class="fn">default</a>() -> Self</h4></section></summary><div class='docblock'>Returns the “default value” for a type. <a href="https://doc.rust-lang.org/1.69.0/core/default/trait.Default.html#tymethod.default">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Display-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1870-1876">source</a><a href="#impl-Display-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></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" title="mod chrono::format::strftime"><code>dt.format("%Y-%m-%d %H:%M:%S%.f")</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-27"><a href="#example-27">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::NaiveDate;
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2016</span>, <span class="number">11</span>, <span class="number">15</span>).unwrap().and_hms_opt(<span class="number">7</span>, <span class="number">39</span>, <span class="number">24</span>).unwrap();
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, dt), <span class="string">"2016-11-15 07:39:24"</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>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).unwrap().and_hms_milli_opt(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>).unwrap();
<span class="macro">assert_eq!</span>(<span class="macro">format!</span>(<span class="string">"{}"</span>, dt), <span class="string">"2015-06-30 23:59:60.500"</span>);</code></pre></div>
</div><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1871-1875">source</a><a href="#method.fmt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Display.html#tymethod.fmt" class="fn">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/1.69.0/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Display.html#tymethod.fmt">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-DurationRound-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/round.rs.html#157-167">source</a><a href="#impl-DurationRound-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="../trait.DurationRound.html" title="trait chrono::DurationRound">DurationRound</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Err-1" class="associatedtype trait-impl"><a href="#associatedtype.Err-1" class="anchor">§</a><h4 class="code-header">type <a href="../trait.DurationRound.html#associatedtype.Err" class="associatedtype">Err</a> = <a class="enum" href="../enum.RoundingError.html" title="enum chrono::RoundingError">RoundingError</a></h4></section></summary><div class='docblock'>Error that can occur in rounding or truncating</div></details><details class="toggle method-toggle" open><summary><section id="method.duration_round" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/round.rs.html#160-162">source</a><a href="#method.duration_round" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.DurationRound.html#tymethod.duration_round" class="fn">duration_round</a>(self, duration: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><Self, Self::<a class="associatedtype" href="../trait.DurationRound.html#associatedtype.Err" title="type chrono::DurationRound::Err">Err</a>></h4></section></summary><div class='docblock'>Return a copy rounded by Duration. <a href="../trait.DurationRound.html#tymethod.duration_round">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.duration_trunc" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/round.rs.html#164-166">source</a><a href="#method.duration_trunc" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.DurationRound.html#tymethod.duration_trunc" class="fn">duration_trunc</a>(self, duration: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><Self, Self::<a class="associatedtype" href="../trait.DurationRound.html#associatedtype.Err" title="type chrono::DurationRound::Err">Err</a>></h4></section></summary><div class='docblock'>Return a copy truncated by Duration. <a href="../trait.DurationRound.html#tymethod.duration_trunc">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-From%3CNaiveDateTime%3E-for-NaiveDate" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2010-2014">source</a><a href="#impl-From%3CNaiveDateTime%3E-for-NaiveDate" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>> for <a class="struct" href="struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.from" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/date.rs.html#2011-2013">source</a><a href="#method.from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html#tymethod.from" class="fn">from</a>(naive_datetime: <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> Self</h4></section></summary><div class='docblock'>Converts to this type from the input type.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-FromStr-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1894-1923">source</a><a href="#impl-FromStr-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/str/traits/trait.FromStr.html" title="trait core::str::traits::FromStr">FromStr</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></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" title="mod chrono::format::strftime"><code>%Y-%m-%dT%H:%M:%S%.f</code></a>, as in <code>Debug</code>.</p>
<h4 id="example-39"><a href="#example-39">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDateTime, NaiveDate};
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">18</span>).unwrap().and_hms_opt(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>).unwrap();
<span class="macro">assert_eq!</span>(<span class="string">"2015-09-18T23:56:04"</span>.parse::<NaiveDateTime>(), <span class="prelude-val">Ok</span>(dt));
<span class="kw">let </span>dt = NaiveDate::from_ymd_opt(<span class="number">12345</span>, <span class="number">6</span>, <span class="number">7</span>).unwrap().and_hms_milli_opt(<span class="number">7</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>).unwrap(); <span class="comment">// leap second
</span><span class="macro">assert_eq!</span>(<span class="string">"+12345-6-7T7:59:60.5"</span>.parse::<NaiveDateTime>(), <span class="prelude-val">Ok</span>(dt));
<span class="macro">assert!</span>(<span class="string">"foo"</span>.parse::<NaiveDateTime>().is_err());</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Err" class="associatedtype trait-impl"><a href="#associatedtype.Err" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/str/traits/trait.FromStr.html#associatedtype.Err" class="associatedtype">Err</a> = <a class="struct" href="../format/struct.ParseError.html" title="struct chrono::format::ParseError">ParseError</a></h4></section></summary><div class='docblock'>The associated error which can be returned from parsing.</div></details><details class="toggle method-toggle" open><summary><section id="method.from_str" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1897-1922">source</a><a href="#method.from_str" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/str/traits/trait.FromStr.html#tymethod.from_str" class="fn">from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.str.html">str</a>) -> <a class="type" href="../format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class='docblock'>Parses a string <code>s</code> to return a value of this type. <a href="https://doc.rust-lang.org/1.69.0/core/str/traits/trait.FromStr.html#tymethod.from_str">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Hash-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-Hash-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.hash" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#method.hash" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html#tymethod.hash" class="fn">hash</a><__H: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>>(&self, state: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&mut __H</a>)</h4></section></summary><div class='docblock'>Feeds this value into the given <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html#tymethod.hash">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.hash_slice" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.3.0">1.3.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/hash/mod.rs.html#239-241">source</a></span><a href="#method.hash_slice" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html#method.hash_slice" class="fn">hash_slice</a><H>(data: &<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.slice.html">[Self]</a>, state: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&mut H</a>)<span class="where fmt-newline">where
H: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>,
Self: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h4></section></summary><div class='docblock'>Feeds a slice of this type into the given <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hasher.html" title="trait core::hash::Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/1.69.0/core/hash/trait.Hash.html#method.hash_slice">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Ord-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-Ord-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html" title="trait core::cmp::Ord">Ord</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.cmp" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#method.cmp" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#tymethod.cmp" class="fn">cmp</a>(&self, other: &<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a></h4></section></summary><div class='docblock'>This method returns an <a href="https://doc.rust-lang.org/1.69.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering"><code>Ordering</code></a> between <code>self</code> and <code>other</code>. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#tymethod.cmp">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.max" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#798-801">source</a></span><a href="#method.max" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.max" class="fn">max</a>(self, other: Self) -> Self<span class="where fmt-newline">where
Self: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h4></section></summary><div class='docblock'>Compares and returns the maximum of two values. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.max">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.min" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#822-825">source</a></span><a href="#method.min" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.min" class="fn">min</a>(self, other: Self) -> Self<span class="where fmt-newline">where
Self: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h4></section></summary><div class='docblock'>Compares and returns the minimum of two values. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.min">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clamp" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.50.0">1.50.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#851-855">source</a></span><a href="#method.clamp" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.clamp" class="fn">clamp</a>(self, min: Self, max: Self) -> Self<span class="where fmt-newline">where
Self: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a> + <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a><Self>,</span></h4></section></summary><div class='docblock'>Restrict a value to a certain interval. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Ord.html#method.clamp">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-PartialEq%3CNaiveDateTime%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-PartialEq%3CNaiveDateTime%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialEq.html" title="trait core::cmp::PartialEq">PartialEq</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.eq" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#method.eq" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialEq.html#tymethod.eq" class="fn">eq</a>(&self, other: &<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
by <code>==</code>.</div></details><details class="toggle method-toggle" open><summary><section id="method.ne" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#229">source</a></span><a href="#method.ne" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialEq.html#method.ne" class="fn">ne</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests for <code>!=</code>. The default implementation is almost always
sufficient, and should not be overridden without very good reason.</div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-PartialOrd%3CNaiveDateTime%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-PartialOrd%3CNaiveDateTime%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.partial_cmp" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#method.partial_cmp" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp" class="fn">partial_cmp</a>(&self, other: &<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="enum" href="https://doc.rust-lang.org/1.69.0/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a>></h4></section></summary><div class='docblock'>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.lt" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#1086">source</a></span><a href="#method.lt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.lt" class="fn">lt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code><</code> operator. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.lt">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.le" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#1105">source</a></span><a href="#method.le" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.le" class="fn">le</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code><=</code>
operator. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.le">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.gt" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#1123">source</a></span><a href="#method.gt" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.gt" class="fn">gt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>></code> operator. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.gt">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.ge" class="method trait-impl"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/cmp.rs.html#1142">source</a></span><a href="#method.ge" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.ge" class="fn">ge</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&Rhs</a>) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a></h4></section></summary><div class='docblock'>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>>=</code>
operator. <a href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.PartialOrd.html#method.ge">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CDays%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1802-1808">source</a><a href="#impl-Sub%3CDays%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-10" class="associatedtype trait-impl"><a href="#associatedtype.Output-10" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub-5" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1805-1807">source</a><a href="#method.sub-5" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, days: <a class="struct" href="struct.Days.html" title="struct chrono::naive::Days">Days</a>) -> Self::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" title="type core::ops::arith::Sub::Output">Output</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CDuration%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1680-1687">source</a><a href="#impl-Sub%3CDuration%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></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" title="struct chrono::naive::NaiveTime">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>Panics on underflow or overflow. Use <a href="struct.NaiveDateTime.html#method.checked_sub_signed" title="method chrono::naive::NaiveDateTime::checked_sub_signed"><code>NaiveDateTime::checked_sub_signed</code></a>
to detect that.</p>
<h4 id="example-28"><a href="#example-28">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="kw">let </span>d = from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="kw">let </span>hms = |h, m, s| d.and_hms_opt(h, m, s).unwrap();
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) - Duration::zero(), hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) - Duration::seconds(<span class="number">1</span>), hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) - Duration::seconds(-<span class="number">1</span>), hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) - Duration::seconds(<span class="number">3600 </span>+ <span class="number">60</span>), hms(<span class="number">2</span>, <span class="number">4</span>, <span class="number">7</span>));
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) - Duration::seconds(<span class="number">86_400</span>),
from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).and_hms_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).unwrap());
<span class="macro">assert_eq!</span>(hms(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) - Duration::days(<span class="number">365</span>),
from_ymd(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">9</span>).and_hms_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).unwrap());
<span class="kw">let </span>hmsm = |h, m, s, milli| d.and_hms_milli_opt(h, m, s, milli).unwrap();
<span class="macro">assert_eq!</span>(hmsm(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">450</span>) - Duration::milliseconds(<span class="number">670</span>), hmsm(<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>leap = hmsm(<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>(leap - Duration::zero(), hmsm(<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>(leap - Duration::milliseconds(<span class="number">200</span>), hmsm(<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>(leap - Duration::milliseconds(<span class="number">500</span>), hmsm(<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>(leap - Duration::seconds(<span class="number">60</span>), hmsm(<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>(leap - Duration::days(<span class="number">1</span>),
from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).and_hms_milli_opt(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">300</span>).unwrap());</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-3" class="associatedtype trait-impl"><a href="#associatedtype.Output-3" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub-1" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1684-1686">source</a><a href="#method.sub-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CDuration%3E-for-NaiveDateTime-1" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1689-1698">source</a><a href="#impl-Sub%3CDuration%3E-for-NaiveDateTime-1" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="https://doc.rust-lang.org/1.69.0/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-8" class="associatedtype trait-impl"><a href="#associatedtype.Output-8" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub-4" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1693-1697">source</a><a href="#method.sub-4" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, rhs: <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CFixedOffset%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/offset/fixed.rs.html#228-235">source</a><a href="#impl-Sub%3CFixedOffset%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-4" class="associatedtype trait-impl"><a href="#associatedtype.Output-4" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub-2" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/offset/fixed.rs.html#232-234">source</a><a href="#method.sub-2" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, rhs: <a class="struct" href="../offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>) -> <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CMonths%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1738-1744">source</a><a href="#impl-Sub%3CMonths%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="docblock"><p>A subtraction of Months from <code>NaiveDateTime</code> clamped to valid days in resulting month.</p>
<h4 id="panics-2"><a href="#panics-2">Panics</a></h4>
<p>Panics if the resulting date would be out of range.</p>
<h4 id="example-25"><a href="#example-25">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Months, NaiveDate};
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">01</span>, <span class="number">01</span>).unwrap().and_hms_opt(<span class="number">01</span>, <span class="number">00</span>, <span class="number">00</span>).unwrap() - Months::new(<span class="number">11</span>),
NaiveDate::from_ymd_opt(<span class="number">2013</span>, <span class="number">02</span>, <span class="number">01</span>).unwrap().and_hms_opt(<span class="number">01</span>, <span class="number">00</span>, <span class="number">00</span>).unwrap()
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">01</span>, <span class="number">01</span>).unwrap().and_hms_opt(<span class="number">00</span>, <span class="number">02</span>, <span class="number">00</span>).unwrap() - Months::new(<span class="number">12</span>),
NaiveDate::from_ymd_opt(<span class="number">2013</span>, <span class="number">01</span>, <span class="number">01</span>).unwrap().and_hms_opt(<span class="number">00</span>, <span class="number">02</span>, <span class="number">00</span>).unwrap()
);
<span class="macro">assert_eq!</span>(
NaiveDate::from_ymd_opt(<span class="number">2014</span>, <span class="number">01</span>, <span class="number">01</span>).unwrap().and_hms_opt(<span class="number">00</span>, <span class="number">00</span>, <span class="number">03</span>).unwrap() - Months::new(<span class="number">13</span>),
NaiveDate::from_ymd_opt(<span class="number">2012</span>, <span class="number">12</span>, <span class="number">01</span>).unwrap().and_hms_opt(<span class="number">00</span>, <span class="number">00</span>, <span class="number">03</span>).unwrap()
);</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output" class="associatedtype trait-impl"><a href="#associatedtype.Output" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1741-1743">source</a><a href="#method.sub" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, rhs: <a class="struct" href="../struct.Months.html" title="struct chrono::Months">Months</a>) -> Self::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" title="type core::ops::arith::Sub::Output">Output</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Sub%3CNaiveDateTime%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1785-1792">source</a><a href="#impl-Sub%3CNaiveDateTime%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></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="struct.NaiveDateTime.html#method.signed_duration_since" title="method chrono::naive::NaiveDateTime::signed_duration_since"><code>NaiveDateTime::signed_duration_since</code></a>.</p>
<h4 id="example-38"><a href="#example-38">Example</a></h4>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{Duration, NaiveDate};
<span class="kw">let </span>from_ymd = |y, m, d| NaiveDate::from_ymd_opt(y, m, d).unwrap();
<span class="kw">let </span>d = from_ymd(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
<span class="macro">assert_eq!</span>(d.and_hms_opt(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).unwrap() - d.and_hms_opt(<span class="number">2</span>, <span class="number">4</span>, <span class="number">6</span>).unwrap(), Duration::seconds(<span class="number">3600 </span>+ <span class="number">60 </span>+ <span class="number">1</span>));
<span class="comment">// July 8 is 190th day in the year 2016
</span><span class="kw">let </span>d0 = from_ymd(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>);
<span class="macro">assert_eq!</span>(d.and_hms_milli_opt(<span class="number">0</span>, <span class="number">7</span>, <span class="number">6</span>, <span class="number">500</span>).unwrap() - d0.and_hms_opt(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap(),
Duration::seconds(<span class="number">189 </span>* <span class="number">86_400 </span>+ <span class="number">7 </span>* <span class="number">60 </span>+ <span class="number">6</span>) + Duration::milliseconds(<span class="number">500</span>));</code></pre></div>
<p>Leap seconds are handled, but the subtraction assumes that no other leap
seconds happened.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span>leap = from_ymd(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).and_hms_milli_opt(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>).unwrap();
<span class="macro">assert_eq!</span>(leap - from_ymd(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).and_hms_opt(<span class="number">23</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap(),
Duration::seconds(<span class="number">3600</span>) + Duration::milliseconds(<span class="number">500</span>));
<span class="macro">assert_eq!</span>(from_ymd(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).and_hms_opt(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).unwrap() - leap,
Duration::seconds(<span class="number">3600</span>) - Duration::milliseconds(<span class="number">500</span>));</code></pre></div>
</div><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Output-6" class="associatedtype trait-impl"><a href="#associatedtype.Output-6" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#associatedtype.Output" class="associatedtype">Output</a> = <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a></h4></section></summary><div class='docblock'>The resulting type after applying the <code>-</code> operator.</div></details><details class="toggle method-toggle" open><summary><section id="method.sub-3" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1789-1791">source</a><a href="#method.sub-3" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub" class="fn">sub</a>(self, rhs: <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a></h4></section></summary><div class='docblock'>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-SubAssign%3CDuration%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1707-1712">source</a><a href="#impl-SubAssign%3CDuration%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html" title="trait core::ops::arith::SubAssign">SubAssign</a><<a class="struct" href="https://doc.rust-lang.org/1.69.0/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.sub_assign" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1709-1711">source</a><a href="#method.sub_assign" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign" class="fn">sub_assign</a>(&mut self, rhs: <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/time/struct.Duration.html" title="struct core::time::Duration">Duration</a>)</h4></section></summary><div class='docblock'>Performs the <code>-=</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-SubAssign%3CDuration%3E-for-NaiveDateTime-1" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1700-1705">source</a><a href="#impl-SubAssign%3CDuration%3E-for-NaiveDateTime-1" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html" title="trait core::ops::arith::SubAssign">SubAssign</a><<a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.sub_assign-1" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1702-1704">source</a><a href="#method.sub_assign-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign" class="fn">sub_assign</a>(&mut self, rhs: <a class="struct" href="../struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</h4></section></summary><div class='docblock'>Performs the <code>-=</code> operation. <a href="https://doc.rust-lang.org/1.69.0/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign">Read more</a></div></details></div></details><details class="toggle implementors-toggle" open><summary><section id="impl-Timelike-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1328-1499">source</a><a href="#impl-Timelike-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">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></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.hour" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1342-1344">source</a><a href="#method.hour" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.hour" class="fn">hour</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the hour number from 0 to 23.</p>
<p>See also the <a href="struct.NaiveTime.html#method.hour" title="method chrono::naive::NaiveTime::hour"><code>NaiveTime::hour</code></a> method.</p>
<h5 id="example-29"><a href="#example-29">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Timelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.hour(), <span class="number">12</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.minute" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1359-1361">source</a><a href="#method.minute" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.minute" class="fn">minute</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the minute number from 0 to 59.</p>
<p>See also the <a href="struct.NaiveTime.html#method.minute" title="method chrono::naive::NaiveTime::minute"><code>NaiveTime::minute</code></a> method.</p>
<h5 id="example-30"><a href="#example-30">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Timelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.minute(), <span class="number">34</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.second" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1376-1378">source</a><a href="#method.second" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.second" class="fn">second</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the second number from 0 to 59.</p>
<p>See also the <a href="struct.NaiveTime.html#method.second" title="method chrono::naive::NaiveTime::second"><code>NaiveTime::second</code></a> method.</p>
<h5 id="example-31"><a href="#example-31">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Timelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.second(), <span class="number">56</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.nanosecond" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1395-1397">source</a><a href="#method.nanosecond" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.nanosecond" class="fn">nanosecond</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class="docblock"><p>Returns the 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" title="method chrono::naive::NaiveTime::nanosecond"><code>NaiveTime::nanosecond</code></a> method.</p>
<h5 id="example-32"><a href="#example-32">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Timelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.nanosecond(), <span class="number">789_000_000</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_hour" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1418-1420">source</a><a href="#method.with_hour" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.with_hour" class="fn">with_hour</a>(&self, hour: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the hour number changed.</p>
<p>See also the <a href="struct.NaiveTime.html#method.with_hour" title="method chrono::naive::NaiveTime::with_hour"><code>NaiveTime::with_hour</code></a> method.</p>
<h5 id="errors-8"><a href="#errors-8">Errors</a></h5>
<p>Returns <code>None</code> if the value for <code>hour</code> is invalid.</p>
<h5 id="example-33"><a href="#example-33">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Timelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_hour(<span class="number">7</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">7</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_hour(<span class="number">24</span>), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_minute" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1441-1443">source</a><a href="#method.with_minute" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.with_minute" class="fn">with_minute</a>(&self, min: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the minute number changed.</p>
<p>See also the <a href="struct.NaiveTime.html#method.with_minute" title="method chrono::naive::NaiveTime::with_minute"><code>NaiveTime::with_minute</code></a> method.</p>
<h5 id="errors-9"><a href="#errors-9">Errors</a></h5>
<p>Returns <code>None</code> if the value for <code>minute</code> is invalid.</p>
<h5 id="example-34"><a href="#example-34">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Timelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_minute(<span class="number">45</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">45</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_minute(<span class="number">60</span>), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_second" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1467-1469">source</a><a href="#method.with_second" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.with_second" class="fn">with_second</a>(&self, sec: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the second number changed.</p>
<p>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" title="method chrono::naive::NaiveTime::with_second"><code>NaiveTime::with_second</code></a> method.</p>
<h5 id="errors-10"><a href="#errors-10">Errors</a></h5>
<p>Returns <code>None</code> if the value for <code>second</code> is invalid.</p>
<h5 id="example-35"><a href="#example-35">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Timelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_second(<span class="number">17</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">17</span>, <span class="number">789</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_second(<span class="number">60</span>), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.with_nanosecond" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#1496-1498">source</a><a href="#method.with_nanosecond" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#tymethod.with_nanosecond" class="fn">with_nanosecond</a>(&self, nano: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></h4></section></summary><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> 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="struct.NaiveDateTime.html#method.nanosecond" title="method chrono::naive::NaiveDateTime::nanosecond"><code>NaiveDateTime::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" title="method chrono::naive::NaiveTime::with_nanosecond"><code>NaiveTime::with_nanosecond</code></a> method.</p>
<h5 id="errors-11"><a href="#errors-11">Errors</a></h5>
<p>Returns <code>None</code> if <code>nanosecond >= 2,000,000,000</code>.</p>
<h5 id="example-36"><a href="#example-36">Example</a></h5>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">use </span>chrono::{NaiveDate, NaiveDateTime, Timelike};
<span class="kw">let </span>dt: NaiveDateTime = NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_milli_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">789</span>).unwrap();
<span class="macro">assert_eq!</span>(dt.with_nanosecond(<span class="number">333_333_333</span>),
<span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_nano_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">333_333_333</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_nanosecond(<span class="number">1_333_333_333</span>), <span class="comment">// leap second
</span><span class="prelude-val">Some</span>(NaiveDate::from_ymd_opt(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).unwrap().and_hms_nano_opt(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_333_333_333</span>).unwrap()));
<span class="macro">assert_eq!</span>(dt.with_nanosecond(<span class="number">2_000_000_000</span>), <span class="prelude-val">None</span>);</code></pre></div>
</div></details><details class="toggle method-toggle" open><summary><section id="method.hour12" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/traits.rs.html#274-281">source</a><a href="#method.hour12" class="anchor">§</a><h4 class="code-header">fn <a href="../trait.Timelike.html#method.hour12" class="fn">hour12</a>(&self) -> (<a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.bool.html">bool</a>, <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a>)</h4></section></summary><div class='docblock'>Returns the hour number from 1 to 12 with a boolean flag,
which is false for AM and true for PM.</div></details><details class="toggle method-toggle" open><summary><section id="method.num_seconds_from_midnight" class="method trait-impl"><a class="srclink rightside" href="../../src/chrono/traits.rs.html#325-327">source</a><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="fn">num_seconds_from_midnight</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.u32.html">u32</a></h4></section></summary><div class='docblock'>Returns the number of non-leap seconds past the last midnight. <a href="../trait.Timelike.html#method.num_seconds_from_midnight">Read more</a></div></details></div></details><section id="impl-Copy-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-Copy-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Copy.html" title="trait core::marker::Copy">Copy</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section><section id="impl-Eq-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-Eq-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section><section id="impl-StructuralEq-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-StructuralEq-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.StructuralEq.html" title="trait core::marker::StructuralEq">StructuralEq</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section><section id="impl-StructuralPartialEq-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="../../src/chrono/naive/datetime/mod.rs.html#75">source</a><a href="#impl-StructuralPartialEq-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.StructuralPartialEq.html" title="trait core::marker::StructuralPartialEq">StructuralPartialEq</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor">§</a></h2><div id="synthetic-implementations-list"><section id="impl-RefUnwindSafe-for-NaiveDateTime" class="impl"><a href="#impl-RefUnwindSafe-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section><section id="impl-Send-for-NaiveDateTime" class="impl"><a href="#impl-Send-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section><section id="impl-Sync-for-NaiveDateTime" class="impl"><a href="#impl-Sync-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section><section id="impl-Unpin-for-NaiveDateTime" class="impl"><a href="#impl-Unpin-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section><section id="impl-UnwindSafe-for-NaiveDateTime" class="impl"><a href="#impl-UnwindSafe-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/panic/unwind_safe/trait.UnwindSafe.html" title="trait core::panic::unwind_safe::UnwindSafe">UnwindSafe</a> for <a class="struct" href="struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></h3></section></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor">§</a></h2><div id="blanket-implementations-list"><details class="toggle implementors-toggle"><summary><section id="impl-Any-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/any.rs.html#200">source</a><a href="#impl-Any-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T<span class="where fmt-newline">where
T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/any.rs.html#201">source</a><a href="#method.type_id" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/any/trait.Any.html#tymethod.type_id" class="fn">type_id</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/1.69.0/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/1.69.0/core/any/trait.Any.html#tymethod.type_id">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/borrow.rs.html#211">source</a><a href="#impl-Borrow%3CT%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><T> for T<span class="where fmt-newline">where
T: ?<a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/borrow.rs.html#213">source</a></span><a href="#method.borrow" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.Borrow.html#tymethod.borrow" class="fn">borrow</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&T</a></h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/borrow.rs.html#220">source</a><a href="#impl-BorrowMut%3CT%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a><T> for T<span class="where fmt-newline">where
T: ?<a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/borrow.rs.html#221">source</a></span><a href="#method.borrow_mut" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fn">borrow_mut</a>(&mut self) -> <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&mut T</a></h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.69.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#733">source</a><a href="#impl-From%3CT%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for T</h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.from-1" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#736">source</a></span><a href="#method.from-1" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html#tymethod.from" class="fn">from</a>(t: T) -> T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#717">source</a><a href="#impl-Into%3CU%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><U> for T<span class="where fmt-newline">where
U: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.into" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#725">source</a></span><a href="#method.into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.Into.html#tymethod.into" class="fn">into</a>(self) -> U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p>
<p>That is, this conversion is whatever the implementation of
<code><a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for U</code> chooses to do.</p>
</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-ToOwned-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/borrow.rs.html#82">source</a><a href="#impl-ToOwned-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T<span class="where fmt-newline">where
T: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Owned" class="associatedtype trait-impl"><a href="#associatedtype.Owned" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="associatedtype">Owned</a> = T</h4></section></summary><div class='docblock'>The resulting type after obtaining ownership.</div></details><details class="toggle method-toggle" open><summary><section id="method.to_owned" class="method trait-impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/borrow.rs.html#87">source</a><a href="#method.to_owned" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fn">to_owned</a>(&self) -> T</h4></section></summary><div class='docblock'>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></div></details><details class="toggle method-toggle" open><summary><section id="method.clone_into" class="method trait-impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/borrow.rs.html#91">source</a><a href="#method.clone_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fn">clone_into</a>(&self, target: <a class="primitive" href="https://doc.rust-lang.org/1.69.0/std/primitive.reference.html">&mut T</a>)</h4></section></summary><div class='docblock'>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/1.69.0/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-ToString-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/string.rs.html#2522">source</a><a href="#impl-ToString-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T> <a class="trait" href="https://doc.rust-lang.org/1.69.0/alloc/string/trait.ToString.html" title="trait alloc::string::ToString">ToString</a> for T<span class="where fmt-newline">where
T: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + ?<a class="trait" href="https://doc.rust-lang.org/1.69.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,</span></h3></section></summary><div class="impl-items"><details class="toggle method-toggle" open><summary><section id="method.to_string" class="method trait-impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/alloc/string.rs.html#2528">source</a><a href="#method.to_string" class="anchor">§</a><h4 class="code-header">default fn <a href="https://doc.rust-lang.org/1.69.0/alloc/string/trait.ToString.html#tymethod.to_string" class="fn">to_string</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/1.69.0/alloc/string/struct.String.html" title="struct alloc::string::String">String</a></h4></section></summary><div class='docblock'>Converts the given value to a <code>String</code>. <a href="https://doc.rust-lang.org/1.69.0/alloc/string/trait.ToString.html#tymethod.to_string">Read more</a></div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#775">source</a><a href="#impl-TryFrom%3CU%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U> for T<span class="where fmt-newline">where
U: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><T>,</span></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Error-1" class="associatedtype trait-impl"><a href="#associatedtype.Error-1" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#associatedtype.Error" class="associatedtype">Error</a> = <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#781">source</a></span><a href="#method.try_from" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#tymethod.try_from" class="fn">try_from</a>(value: U) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><T, <T as <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-NaiveDateTime" class="impl"><a class="srclink rightside" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#760">source</a><a href="#impl-TryInto%3CU%3E-for-NaiveDateTime" class="anchor">§</a><h3 class="code-header">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a><U> for T<span class="where fmt-newline">where
U: <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>,</span></h3></section></summary><div class="impl-items"><details class="toggle" open><summary><section id="associatedtype.Error" class="associatedtype trait-impl"><a href="#associatedtype.Error" class="anchor">§</a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryInto.html#associatedtype.Error" class="associatedtype">Error</a> = <U as <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.69.0/src/core/convert/mod.rs.html#766">source</a></span><a href="#method.try_into" class="anchor">§</a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryInto.html#tymethod.try_into" class="fn">try_into</a>(self) -> <a class="enum" href="https://doc.rust-lang.org/1.69.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a><U, <U as <a class="trait" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="associatedtype" href="https://doc.rust-lang.org/1.69.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details></div></section></div></main><div id="rustdoc-vars" data-root-path="../../" data-static-root-path="../../static.files/" data-current-crate="chrono" data-themes="" data-resource-suffix="" data-rustdoc-version="1.69.0 (84c898d65 2023-04-16) (built from a source tarball)" data-search-js="search-8a59a8356673ec1f.js" data-settings-js="settings-f0c5c39777a9a2f6.js" data-settings-css="settings-0bcba95ff279c1db.css" ></div></body></html>