| <!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="Source of the Rust file `/root/.cargo/registry/src/github.com-1ecc6299db9ec823/chrono-0.4.26/src/lib.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>lib.rs - source</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" href="../../normalize.css"><link rel="stylesheet" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" href="../../ayu.css" disabled><link rel="stylesheet" href="../../dark.css" disabled><link rel="stylesheet" href="../../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../../storage.js"></script><script defer src="../../source-script.js"></script><script defer src="../../source-files.js"></script><script defer src="../../main.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="alternate icon" type="image/png" href="../../favicon-16x16.png"><link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><link rel="icon" type="image/svg+xml" href="../../favicon.svg"></head><body class="rustdoc source"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><a class="sidebar-logo" href="../../chrono/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div></a></nav><main><div class="width-limiter"><nav class="sub"><a class="sub-logo-container" href="../../chrono/index.html"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></a><form class="search-form"><div class="search-container"><span></span><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><div id="help-button" title="help" tabindex="-1"><a href="../../help.html">?</a></div><div id="settings-menu" tabindex="-1"><a href="../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../wheel.svg"></a></div></div></form></nav><section id="main-content" class="content"><div class="example-wrap"><pre class="src-line-numbers"><span id="1">1</span> |
| <span id="2">2</span> |
| <span id="3">3</span> |
| <span id="4">4</span> |
| <span id="5">5</span> |
| <span id="6">6</span> |
| <span id="7">7</span> |
| <span id="8">8</span> |
| <span id="9">9</span> |
| <span id="10">10</span> |
| <span id="11">11</span> |
| <span id="12">12</span> |
| <span id="13">13</span> |
| <span id="14">14</span> |
| <span id="15">15</span> |
| <span id="16">16</span> |
| <span id="17">17</span> |
| <span id="18">18</span> |
| <span id="19">19</span> |
| <span id="20">20</span> |
| <span id="21">21</span> |
| <span id="22">22</span> |
| <span id="23">23</span> |
| <span id="24">24</span> |
| <span id="25">25</span> |
| <span id="26">26</span> |
| <span id="27">27</span> |
| <span id="28">28</span> |
| <span id="29">29</span> |
| <span id="30">30</span> |
| <span id="31">31</span> |
| <span id="32">32</span> |
| <span id="33">33</span> |
| <span id="34">34</span> |
| <span id="35">35</span> |
| <span id="36">36</span> |
| <span id="37">37</span> |
| <span id="38">38</span> |
| <span id="39">39</span> |
| <span id="40">40</span> |
| <span id="41">41</span> |
| <span id="42">42</span> |
| <span id="43">43</span> |
| <span id="44">44</span> |
| <span id="45">45</span> |
| <span id="46">46</span> |
| <span id="47">47</span> |
| <span id="48">48</span> |
| <span id="49">49</span> |
| <span id="50">50</span> |
| <span id="51">51</span> |
| <span id="52">52</span> |
| <span id="53">53</span> |
| <span id="54">54</span> |
| <span id="55">55</span> |
| <span id="56">56</span> |
| <span id="57">57</span> |
| <span id="58">58</span> |
| <span id="59">59</span> |
| <span id="60">60</span> |
| <span id="61">61</span> |
| <span id="62">62</span> |
| <span id="63">63</span> |
| <span id="64">64</span> |
| <span id="65">65</span> |
| <span id="66">66</span> |
| <span id="67">67</span> |
| <span id="68">68</span> |
| <span id="69">69</span> |
| <span id="70">70</span> |
| <span id="71">71</span> |
| <span id="72">72</span> |
| <span id="73">73</span> |
| <span id="74">74</span> |
| <span id="75">75</span> |
| <span id="76">76</span> |
| <span id="77">77</span> |
| <span id="78">78</span> |
| <span id="79">79</span> |
| <span id="80">80</span> |
| <span id="81">81</span> |
| <span id="82">82</span> |
| <span id="83">83</span> |
| <span id="84">84</span> |
| <span id="85">85</span> |
| <span id="86">86</span> |
| <span id="87">87</span> |
| <span id="88">88</span> |
| <span id="89">89</span> |
| <span id="90">90</span> |
| <span id="91">91</span> |
| <span id="92">92</span> |
| <span id="93">93</span> |
| <span id="94">94</span> |
| <span id="95">95</span> |
| <span id="96">96</span> |
| <span id="97">97</span> |
| <span id="98">98</span> |
| <span id="99">99</span> |
| <span id="100">100</span> |
| <span id="101">101</span> |
| <span id="102">102</span> |
| <span id="103">103</span> |
| <span id="104">104</span> |
| <span id="105">105</span> |
| <span id="106">106</span> |
| <span id="107">107</span> |
| <span id="108">108</span> |
| <span id="109">109</span> |
| <span id="110">110</span> |
| <span id="111">111</span> |
| <span id="112">112</span> |
| <span id="113">113</span> |
| <span id="114">114</span> |
| <span id="115">115</span> |
| <span id="116">116</span> |
| <span id="117">117</span> |
| <span id="118">118</span> |
| <span id="119">119</span> |
| <span id="120">120</span> |
| <span id="121">121</span> |
| <span id="122">122</span> |
| <span id="123">123</span> |
| <span id="124">124</span> |
| <span id="125">125</span> |
| <span id="126">126</span> |
| <span id="127">127</span> |
| <span id="128">128</span> |
| <span id="129">129</span> |
| <span id="130">130</span> |
| <span id="131">131</span> |
| <span id="132">132</span> |
| <span id="133">133</span> |
| <span id="134">134</span> |
| <span id="135">135</span> |
| <span id="136">136</span> |
| <span id="137">137</span> |
| <span id="138">138</span> |
| <span id="139">139</span> |
| <span id="140">140</span> |
| <span id="141">141</span> |
| <span id="142">142</span> |
| <span id="143">143</span> |
| <span id="144">144</span> |
| <span id="145">145</span> |
| <span id="146">146</span> |
| <span id="147">147</span> |
| <span id="148">148</span> |
| <span id="149">149</span> |
| <span id="150">150</span> |
| <span id="151">151</span> |
| <span id="152">152</span> |
| <span id="153">153</span> |
| <span id="154">154</span> |
| <span id="155">155</span> |
| <span id="156">156</span> |
| <span id="157">157</span> |
| <span id="158">158</span> |
| <span id="159">159</span> |
| <span id="160">160</span> |
| <span id="161">161</span> |
| <span id="162">162</span> |
| <span id="163">163</span> |
| <span id="164">164</span> |
| <span id="165">165</span> |
| <span id="166">166</span> |
| <span id="167">167</span> |
| <span id="168">168</span> |
| <span id="169">169</span> |
| <span id="170">170</span> |
| <span id="171">171</span> |
| <span id="172">172</span> |
| <span id="173">173</span> |
| <span id="174">174</span> |
| <span id="175">175</span> |
| <span id="176">176</span> |
| <span id="177">177</span> |
| <span id="178">178</span> |
| <span id="179">179</span> |
| <span id="180">180</span> |
| <span id="181">181</span> |
| <span id="182">182</span> |
| <span id="183">183</span> |
| <span id="184">184</span> |
| <span id="185">185</span> |
| <span id="186">186</span> |
| <span id="187">187</span> |
| <span id="188">188</span> |
| <span id="189">189</span> |
| <span id="190">190</span> |
| <span id="191">191</span> |
| <span id="192">192</span> |
| <span id="193">193</span> |
| <span id="194">194</span> |
| <span id="195">195</span> |
| <span id="196">196</span> |
| <span id="197">197</span> |
| <span id="198">198</span> |
| <span id="199">199</span> |
| <span id="200">200</span> |
| <span id="201">201</span> |
| <span id="202">202</span> |
| <span id="203">203</span> |
| <span id="204">204</span> |
| <span id="205">205</span> |
| <span id="206">206</span> |
| <span id="207">207</span> |
| <span id="208">208</span> |
| <span id="209">209</span> |
| <span id="210">210</span> |
| <span id="211">211</span> |
| <span id="212">212</span> |
| <span id="213">213</span> |
| <span id="214">214</span> |
| <span id="215">215</span> |
| <span id="216">216</span> |
| <span id="217">217</span> |
| <span id="218">218</span> |
| <span id="219">219</span> |
| <span id="220">220</span> |
| <span id="221">221</span> |
| <span id="222">222</span> |
| <span id="223">223</span> |
| <span id="224">224</span> |
| <span id="225">225</span> |
| <span id="226">226</span> |
| <span id="227">227</span> |
| <span id="228">228</span> |
| <span id="229">229</span> |
| <span id="230">230</span> |
| <span id="231">231</span> |
| <span id="232">232</span> |
| <span id="233">233</span> |
| <span id="234">234</span> |
| <span id="235">235</span> |
| <span id="236">236</span> |
| <span id="237">237</span> |
| <span id="238">238</span> |
| <span id="239">239</span> |
| <span id="240">240</span> |
| <span id="241">241</span> |
| <span id="242">242</span> |
| <span id="243">243</span> |
| <span id="244">244</span> |
| <span id="245">245</span> |
| <span id="246">246</span> |
| <span id="247">247</span> |
| <span id="248">248</span> |
| <span id="249">249</span> |
| <span id="250">250</span> |
| <span id="251">251</span> |
| <span id="252">252</span> |
| <span id="253">253</span> |
| <span id="254">254</span> |
| <span id="255">255</span> |
| <span id="256">256</span> |
| <span id="257">257</span> |
| <span id="258">258</span> |
| <span id="259">259</span> |
| <span id="260">260</span> |
| <span id="261">261</span> |
| <span id="262">262</span> |
| <span id="263">263</span> |
| <span id="264">264</span> |
| <span id="265">265</span> |
| <span id="266">266</span> |
| <span id="267">267</span> |
| <span id="268">268</span> |
| <span id="269">269</span> |
| <span id="270">270</span> |
| <span id="271">271</span> |
| <span id="272">272</span> |
| <span id="273">273</span> |
| <span id="274">274</span> |
| <span id="275">275</span> |
| <span id="276">276</span> |
| <span id="277">277</span> |
| <span id="278">278</span> |
| <span id="279">279</span> |
| <span id="280">280</span> |
| <span id="281">281</span> |
| <span id="282">282</span> |
| <span id="283">283</span> |
| <span id="284">284</span> |
| <span id="285">285</span> |
| <span id="286">286</span> |
| <span id="287">287</span> |
| <span id="288">288</span> |
| <span id="289">289</span> |
| <span id="290">290</span> |
| <span id="291">291</span> |
| <span id="292">292</span> |
| <span id="293">293</span> |
| <span id="294">294</span> |
| <span id="295">295</span> |
| <span id="296">296</span> |
| <span id="297">297</span> |
| <span id="298">298</span> |
| <span id="299">299</span> |
| <span id="300">300</span> |
| <span id="301">301</span> |
| <span id="302">302</span> |
| <span id="303">303</span> |
| <span id="304">304</span> |
| <span id="305">305</span> |
| <span id="306">306</span> |
| <span id="307">307</span> |
| <span id="308">308</span> |
| <span id="309">309</span> |
| <span id="310">310</span> |
| <span id="311">311</span> |
| <span id="312">312</span> |
| <span id="313">313</span> |
| <span id="314">314</span> |
| <span id="315">315</span> |
| <span id="316">316</span> |
| <span id="317">317</span> |
| <span id="318">318</span> |
| <span id="319">319</span> |
| <span id="320">320</span> |
| <span id="321">321</span> |
| <span id="322">322</span> |
| <span id="323">323</span> |
| <span id="324">324</span> |
| <span id="325">325</span> |
| <span id="326">326</span> |
| <span id="327">327</span> |
| <span id="328">328</span> |
| <span id="329">329</span> |
| <span id="330">330</span> |
| <span id="331">331</span> |
| <span id="332">332</span> |
| <span id="333">333</span> |
| <span id="334">334</span> |
| <span id="335">335</span> |
| <span id="336">336</span> |
| <span id="337">337</span> |
| <span id="338">338</span> |
| <span id="339">339</span> |
| <span id="340">340</span> |
| <span id="341">341</span> |
| <span id="342">342</span> |
| <span id="343">343</span> |
| <span id="344">344</span> |
| <span id="345">345</span> |
| <span id="346">346</span> |
| <span id="347">347</span> |
| <span id="348">348</span> |
| <span id="349">349</span> |
| <span id="350">350</span> |
| <span id="351">351</span> |
| <span id="352">352</span> |
| <span id="353">353</span> |
| <span id="354">354</span> |
| <span id="355">355</span> |
| <span id="356">356</span> |
| <span id="357">357</span> |
| <span id="358">358</span> |
| <span id="359">359</span> |
| <span id="360">360</span> |
| <span id="361">361</span> |
| <span id="362">362</span> |
| <span id="363">363</span> |
| <span id="364">364</span> |
| <span id="365">365</span> |
| <span id="366">366</span> |
| <span id="367">367</span> |
| <span id="368">368</span> |
| <span id="369">369</span> |
| <span id="370">370</span> |
| <span id="371">371</span> |
| <span id="372">372</span> |
| <span id="373">373</span> |
| <span id="374">374</span> |
| <span id="375">375</span> |
| <span id="376">376</span> |
| <span id="377">377</span> |
| <span id="378">378</span> |
| <span id="379">379</span> |
| <span id="380">380</span> |
| <span id="381">381</span> |
| <span id="382">382</span> |
| <span id="383">383</span> |
| <span id="384">384</span> |
| <span id="385">385</span> |
| <span id="386">386</span> |
| <span id="387">387</span> |
| <span id="388">388</span> |
| <span id="389">389</span> |
| <span id="390">390</span> |
| <span id="391">391</span> |
| <span id="392">392</span> |
| <span id="393">393</span> |
| <span id="394">394</span> |
| <span id="395">395</span> |
| <span id="396">396</span> |
| <span id="397">397</span> |
| <span id="398">398</span> |
| <span id="399">399</span> |
| <span id="400">400</span> |
| <span id="401">401</span> |
| <span id="402">402</span> |
| <span id="403">403</span> |
| <span id="404">404</span> |
| <span id="405">405</span> |
| <span id="406">406</span> |
| <span id="407">407</span> |
| <span id="408">408</span> |
| <span id="409">409</span> |
| <span id="410">410</span> |
| <span id="411">411</span> |
| <span id="412">412</span> |
| <span id="413">413</span> |
| <span id="414">414</span> |
| <span id="415">415</span> |
| <span id="416">416</span> |
| <span id="417">417</span> |
| <span id="418">418</span> |
| <span id="419">419</span> |
| <span id="420">420</span> |
| <span id="421">421</span> |
| <span id="422">422</span> |
| <span id="423">423</span> |
| <span id="424">424</span> |
| <span id="425">425</span> |
| <span id="426">426</span> |
| <span id="427">427</span> |
| <span id="428">428</span> |
| <span id="429">429</span> |
| <span id="430">430</span> |
| <span id="431">431</span> |
| <span id="432">432</span> |
| <span id="433">433</span> |
| <span id="434">434</span> |
| <span id="435">435</span> |
| <span id="436">436</span> |
| <span id="437">437</span> |
| <span id="438">438</span> |
| <span id="439">439</span> |
| <span id="440">440</span> |
| <span id="441">441</span> |
| <span id="442">442</span> |
| <span id="443">443</span> |
| <span id="444">444</span> |
| <span id="445">445</span> |
| <span id="446">446</span> |
| <span id="447">447</span> |
| <span id="448">448</span> |
| <span id="449">449</span> |
| <span id="450">450</span> |
| <span id="451">451</span> |
| <span id="452">452</span> |
| <span id="453">453</span> |
| <span id="454">454</span> |
| <span id="455">455</span> |
| <span id="456">456</span> |
| <span id="457">457</span> |
| <span id="458">458</span> |
| <span id="459">459</span> |
| <span id="460">460</span> |
| <span id="461">461</span> |
| <span id="462">462</span> |
| <span id="463">463</span> |
| <span id="464">464</span> |
| <span id="465">465</span> |
| <span id="466">466</span> |
| <span id="467">467</span> |
| <span id="468">468</span> |
| <span id="469">469</span> |
| <span id="470">470</span> |
| <span id="471">471</span> |
| <span id="472">472</span> |
| <span id="473">473</span> |
| <span id="474">474</span> |
| <span id="475">475</span> |
| <span id="476">476</span> |
| <span id="477">477</span> |
| <span id="478">478</span> |
| <span id="479">479</span> |
| <span id="480">480</span> |
| <span id="481">481</span> |
| <span id="482">482</span> |
| <span id="483">483</span> |
| <span id="484">484</span> |
| <span id="485">485</span> |
| <span id="486">486</span> |
| <span id="487">487</span> |
| <span id="488">488</span> |
| <span id="489">489</span> |
| <span id="490">490</span> |
| <span id="491">491</span> |
| <span id="492">492</span> |
| <span id="493">493</span> |
| <span id="494">494</span> |
| <span id="495">495</span> |
| <span id="496">496</span> |
| <span id="497">497</span> |
| <span id="498">498</span> |
| <span id="499">499</span> |
| <span id="500">500</span> |
| <span id="501">501</span> |
| <span id="502">502</span> |
| <span id="503">503</span> |
| <span id="504">504</span> |
| <span id="505">505</span> |
| <span id="506">506</span> |
| <span id="507">507</span> |
| <span id="508">508</span> |
| <span id="509">509</span> |
| <span id="510">510</span> |
| <span id="511">511</span> |
| <span id="512">512</span> |
| <span id="513">513</span> |
| <span id="514">514</span> |
| <span id="515">515</span> |
| <span id="516">516</span> |
| <span id="517">517</span> |
| <span id="518">518</span> |
| <span id="519">519</span> |
| <span id="520">520</span> |
| <span id="521">521</span> |
| <span id="522">522</span> |
| <span id="523">523</span> |
| <span id="524">524</span> |
| <span id="525">525</span> |
| <span id="526">526</span> |
| <span id="527">527</span> |
| <span id="528">528</span> |
| </pre><pre class="rust"><code><span class="doccomment">//! # Chrono: Date and Time for Rust |
| //! |
| //! It aims to be a feature-complete superset of |
| //! the [time](https://github.com/rust-lang-deprecated/time) library. |
| //! In particular, |
| //! |
| //! * Chrono strictly adheres to ISO 8601. |
| //! * Chrono is timezone-aware by default, with separate timezone-naive types. |
| //! * Chrono is space-optimal and (while not being the primary goal) reasonably efficient. |
| //! |
| //! There were several previous attempts to bring a good date and time library to Rust, |
| //! which Chrono builds upon and should acknowledge: |
| //! |
| //! * [Initial research on |
| //! the wiki](https://github.com/rust-lang/rust-wiki-backup/blob/master/Lib-datetime.md) |
| //! * Dietrich Epp's [datetime-rs](https://github.com/depp/datetime-rs) |
| //! * Luis de Bethencourt's [rust-datetime](https://github.com/luisbg/rust-datetime) |
| //! |
| //! ### Features |
| //! |
| //! Chrono supports various runtime environments and operating systems, and has |
| //! several features that may be enabled or disabled. |
| //! |
| //! Default features: |
| //! |
| //! - `alloc`: Enable features that depend on allocation (primarily string formatting) |
| //! - `std`: Enables functionality that depends on the standard library. This |
| //! is a superset of `alloc` and adds interoperation with standard library types |
| //! and traits. |
| //! - `clock`: Enables reading the system time (`now`) that depends on the standard library for |
| //! UNIX-like operating systems and the Windows API (`winapi`) for Windows. |
| //! |
| //! Optional features: |
| //! |
| //! - [`serde`][]: Enable serialization/deserialization via serde. |
| //! - `unstable-locales`: Enable localization. This adds various methods with a |
| //! `_localized` suffix. The implementation and API may change or even be |
| //! removed in a patch release. Feedback welcome. |
| //! |
| //! [`serde`]: https://github.com/serde-rs/serde |
| //! [wasm-bindgen]: https://github.com/rustwasm/wasm-bindgen |
| //! |
| //! See the [cargo docs][] for examples of specifying features. |
| //! |
| //! [cargo docs]: https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#choosing-features |
| //! |
| //! ## Overview |
| //! |
| //! ### Duration |
| //! |
| //! Chrono currently uses its own [`Duration`] type to represent the magnitude |
| //! of a time span. Since this has the same name as the newer, standard type for |
| //! duration, the reference will refer this type as `OldDuration`. |
| //! |
| //! Note that this is an "accurate" duration represented as seconds and |
| //! nanoseconds and does not represent "nominal" components such as days or |
| //! months. |
| //! |
| //! When the `oldtime` feature is enabled, [`Duration`] is an alias for the |
| //! [`time::Duration`](https://docs.rs/time/0.1.40/time/struct.Duration.html) |
| //! type from v0.1 of the time crate. time v0.1 is deprecated, so new code |
| //! should disable the `oldtime` feature and use the `chrono::Duration` type |
| //! instead. The `oldtime` feature is enabled by default for backwards |
| //! compatibility, but future versions of Chrono are likely to remove the |
| //! feature entirely. |
| //! |
| //! Chrono does not yet natively support |
| //! the standard [`Duration`](https://doc.rust-lang.org/std/time/struct.Duration.html) type, |
| //! but it will be supported in the future. |
| //! Meanwhile you can convert between two types with |
| //! [`Duration::from_std`](https://docs.rs/time/0.1.40/time/struct.Duration.html#method.from_std) |
| //! and |
| //! [`Duration::to_std`](https://docs.rs/time/0.1.40/time/struct.Duration.html#method.to_std) |
| //! methods. |
| //! |
| //! ### Date and Time |
| //! |
| //! Chrono provides a |
| //! [**`DateTime`**](./struct.DateTime.html) |
| //! type to represent a date and a time in a timezone. |
| //! |
| //! For more abstract moment-in-time tracking such as internal timekeeping |
| //! that is unconcerned with timezones, consider |
| //! [`time::SystemTime`](https://doc.rust-lang.org/std/time/struct.SystemTime.html), |
| //! which tracks your system clock, or |
| //! [`time::Instant`](https://doc.rust-lang.org/std/time/struct.Instant.html), which |
| //! is an opaque but monotonically-increasing representation of a moment in time. |
| //! |
| //! `DateTime` is timezone-aware and must be constructed from |
| //! the [**`TimeZone`**](./offset/trait.TimeZone.html) object, |
| //! which defines how the local date is converted to and back from the UTC date. |
| //! There are three well-known `TimeZone` implementations: |
| //! |
| //! * [**`Utc`**](./offset/struct.Utc.html) specifies the UTC time zone. It is most efficient. |
| //! |
| //! * [**`Local`**](./offset/struct.Local.html) specifies the system local time zone. |
| //! |
| //! * [**`FixedOffset`**](./offset/struct.FixedOffset.html) specifies |
| //! an arbitrary, fixed time zone such as UTC+09:00 or UTC-10:30. |
| //! This often results from the parsed textual date and time. |
| //! Since it stores the most information and does not depend on the system environment, |
| //! you would want to normalize other `TimeZone`s into this type. |
| //! |
| //! `DateTime`s with different `TimeZone` types are distinct and do not mix, |
| //! but can be converted to each other using |
| //! the [`DateTime::with_timezone`](./struct.DateTime.html#method.with_timezone) method. |
| //! |
| //! You can get the current date and time in the UTC time zone |
| //! ([`Utc::now()`](./offset/struct.Utc.html#method.now)) |
| //! or in the local time zone |
| //! ([`Local::now()`](./offset/struct.Local.html#method.now)). |
| //! |
| </span><span class="attribute">#![cfg_attr(not(feature = <span class="string">"clock"</span>), doc = <span class="string">"```ignore"</span>)] |
| #![cfg_attr(feature = <span class="string">"clock"</span>, doc = <span class="string">"```rust"</span>)] |
| </span><span class="doccomment">//! use chrono::prelude::*; |
| //! |
| //! let utc: DateTime<Utc> = Utc::now(); // e.g. `2014-11-28T12:45:59.324310806Z` |
| //! let local: DateTime<Local> = Local::now(); // e.g. `2014-11-28T21:45:59.324310806+09:00` |
| //! # let _ = utc; let _ = local; |
| //! ``` |
| //! |
| //! Alternatively, you can create your own date and time. |
| //! This is a bit verbose due to Rust's lack of function and method overloading, |
| //! but in turn we get a rich combination of initialization methods. |
| //! |
| </span><span class="attribute">#![cfg_attr(not(feature = <span class="string">"std"</span>), doc = <span class="string">"```ignore"</span>)] |
| #![cfg_attr(feature = <span class="string">"std"</span>, doc = <span class="string">"```rust"</span>)] |
| </span><span class="doccomment">//! use chrono::prelude::*; |
| //! use chrono::offset::LocalResult; |
| //! |
| //! # fn doctest() -> Option<()> { |
| //! |
| //! let dt = Utc.with_ymd_and_hms(2014, 7, 8, 9, 10, 11).unwrap(); // `2014-07-08T09:10:11Z` |
| //! assert_eq!(dt, NaiveDate::from_ymd_opt(2014, 7, 8)?.and_hms_opt(9, 10, 11)?.and_local_timezone(Utc).unwrap()); |
| //! |
| //! // July 8 is 188th day of the year 2014 (`o` for "ordinal") |
| //! assert_eq!(dt, NaiveDate::from_yo_opt(2014, 189)?.and_hms_opt(9, 10, 11)?.and_utc()); |
| //! // July 8 is Tuesday in ISO week 28 of the year 2014. |
| //! assert_eq!(dt, NaiveDate::from_isoywd_opt(2014, 28, Weekday::Tue)?.and_hms_opt(9, 10, 11)?.and_utc()); |
| //! |
| //! let dt = NaiveDate::from_ymd_opt(2014, 7, 8)?.and_hms_milli_opt(9, 10, 11, 12)?.and_local_timezone(Utc).unwrap(); // `2014-07-08T09:10:11.012Z` |
| //! assert_eq!(dt, NaiveDate::from_ymd_opt(2014, 7, 8)?.and_hms_micro_opt(9, 10, 11, 12_000)?.and_local_timezone(Utc).unwrap()); |
| //! assert_eq!(dt, NaiveDate::from_ymd_opt(2014, 7, 8)?.and_hms_nano_opt(9, 10, 11, 12_000_000)?.and_local_timezone(Utc).unwrap()); |
| //! |
| //! // dynamic verification |
| //! assert_eq!(Utc.with_ymd_and_hms(2014, 7, 8, 21, 15, 33), |
| //! LocalResult::Single(NaiveDate::from_ymd_opt(2014, 7, 8)?.and_hms_opt(21, 15, 33)?.and_utc())); |
| //! assert_eq!(Utc.with_ymd_and_hms(2014, 7, 8, 80, 15, 33), LocalResult::None); |
| //! assert_eq!(Utc.with_ymd_and_hms(2014, 7, 38, 21, 15, 33), LocalResult::None); |
| //! |
| //! // other time zone objects can be used to construct a local datetime. |
| //! // obviously, `local_dt` is normally different from `dt`, but `fixed_dt` should be identical. |
| //! let local_dt = Local.from_local_datetime(&NaiveDate::from_ymd_opt(2014, 7, 8).unwrap().and_hms_milli_opt(9, 10, 11, 12).unwrap()).unwrap(); |
| //! let fixed_dt = FixedOffset::east_opt(9 * 3600).unwrap().from_local_datetime(&NaiveDate::from_ymd_opt(2014, 7, 8).unwrap().and_hms_milli_opt(18, 10, 11, 12).unwrap()).unwrap(); |
| //! assert_eq!(dt, fixed_dt); |
| //! # let _ = local_dt; |
| //! # Some(()) |
| //! # } |
| //! # doctest().unwrap(); |
| //! ``` |
| //! |
| //! Various properties are available to the date and time, and can be altered individually. |
| //! Most of them are defined in the traits [`Datelike`](./trait.Datelike.html) and |
| //! [`Timelike`](./trait.Timelike.html) which you should `use` before. |
| //! Addition and subtraction is also supported. |
| //! The following illustrates most supported operations to the date and time: |
| //! |
| //! ```rust |
| //! use chrono::prelude::*; |
| //! use chrono::Duration; |
| //! |
| //! // assume this returned `2014-11-28T21:45:59.324310806+09:00`: |
| //! let dt = FixedOffset::east_opt(9*3600).unwrap().from_local_datetime(&NaiveDate::from_ymd_opt(2014, 11, 28).unwrap().and_hms_nano_opt(21, 45, 59, 324310806).unwrap()).unwrap(); |
| //! |
| //! // property accessors |
| //! assert_eq!((dt.year(), dt.month(), dt.day()), (2014, 11, 28)); |
| //! assert_eq!((dt.month0(), dt.day0()), (10, 27)); // for unfortunate souls |
| //! assert_eq!((dt.hour(), dt.minute(), dt.second()), (21, 45, 59)); |
| //! assert_eq!(dt.weekday(), Weekday::Fri); |
| //! assert_eq!(dt.weekday().number_from_monday(), 5); // Mon=1, ..., Sun=7 |
| //! assert_eq!(dt.ordinal(), 332); // the day of year |
| //! assert_eq!(dt.num_days_from_ce(), 735565); // the number of days from and including Jan 1, 1 |
| //! |
| //! // time zone accessor and manipulation |
| //! assert_eq!(dt.offset().fix().local_minus_utc(), 9 * 3600); |
| //! assert_eq!(dt.timezone(), FixedOffset::east_opt(9 * 3600).unwrap()); |
| //! assert_eq!(dt.with_timezone(&Utc), NaiveDate::from_ymd_opt(2014, 11, 28).unwrap().and_hms_nano_opt(12, 45, 59, 324310806).unwrap().and_local_timezone(Utc).unwrap()); |
| //! |
| //! // a sample of property manipulations (validates dynamically) |
| //! assert_eq!(dt.with_day(29).unwrap().weekday(), Weekday::Sat); // 2014-11-29 is Saturday |
| //! assert_eq!(dt.with_day(32), None); |
| //! assert_eq!(dt.with_year(-300).unwrap().num_days_from_ce(), -109606); // November 29, 301 BCE |
| //! |
| //! // arithmetic operations |
| //! let dt1 = Utc.with_ymd_and_hms(2014, 11, 14, 8, 9, 10).unwrap(); |
| //! let dt2 = Utc.with_ymd_and_hms(2014, 11, 14, 10, 9, 8).unwrap(); |
| //! assert_eq!(dt1.signed_duration_since(dt2), Duration::seconds(-2 * 3600 + 2)); |
| //! assert_eq!(dt2.signed_duration_since(dt1), Duration::seconds(2 * 3600 - 2)); |
| //! assert_eq!(Utc.with_ymd_and_hms(1970, 1, 1, 0, 0, 0).unwrap() + Duration::seconds(1_000_000_000), |
| //! Utc.with_ymd_and_hms(2001, 9, 9, 1, 46, 40).unwrap()); |
| //! assert_eq!(Utc.with_ymd_and_hms(1970, 1, 1, 0, 0, 0).unwrap() - Duration::seconds(1_000_000_000), |
| //! Utc.with_ymd_and_hms(1938, 4, 24, 22, 13, 20).unwrap()); |
| //! ``` |
| //! |
| //! ### Formatting and Parsing |
| //! |
| //! Formatting is done via the [`format`](./struct.DateTime.html#method.format) method, |
| //! which format is equivalent to the familiar `strftime` format. |
| //! |
| //! See [`format::strftime`](./format/strftime/index.html#specifiers) |
| //! documentation for full syntax and list of specifiers. |
| //! |
| //! The default `to_string` method and `{:?}` specifier also give a reasonable representation. |
| //! Chrono also provides [`to_rfc2822`](./struct.DateTime.html#method.to_rfc2822) and |
| //! [`to_rfc3339`](./struct.DateTime.html#method.to_rfc3339) methods |
| //! for well-known formats. |
| //! |
| //! Chrono now also provides date formatting in almost any language without the |
| //! help of an additional C library. This functionality is under the feature |
| //! `unstable-locales`: |
| //! |
| //! ```toml |
| //! chrono = { version = "0.4", features = ["unstable-locales"] } |
| //! ``` |
| //! |
| //! The `unstable-locales` feature requires and implies at least the `alloc` feature. |
| //! |
| //! ```rust |
| //! # #[allow(unused_imports)] |
| //! use chrono::prelude::*; |
| //! |
| //! # #[cfg(feature = "unstable-locales")] |
| //! # fn test() { |
| //! let dt = Utc.with_ymd_and_hms(2014, 11, 28, 12, 0, 9).unwrap(); |
| //! assert_eq!(dt.format("%Y-%m-%d %H:%M:%S").to_string(), "2014-11-28 12:00:09"); |
| //! assert_eq!(dt.format("%a %b %e %T %Y").to_string(), "Fri Nov 28 12:00:09 2014"); |
| //! assert_eq!(dt.format_localized("%A %e %B %Y, %T", Locale::fr_BE).to_string(), "vendredi 28 novembre 2014, 12:00:09"); |
| //! |
| //! assert_eq!(dt.format("%a %b %e %T %Y").to_string(), dt.format("%c").to_string()); |
| //! assert_eq!(dt.to_string(), "2014-11-28 12:00:09 UTC"); |
| //! assert_eq!(dt.to_rfc2822(), "Fri, 28 Nov 2014 12:00:09 +0000"); |
| //! assert_eq!(dt.to_rfc3339(), "2014-11-28T12:00:09+00:00"); |
| //! assert_eq!(format!("{:?}", dt), "2014-11-28T12:00:09Z"); |
| //! |
| //! // Note that milli/nanoseconds are only printed if they are non-zero |
| //! let dt_nano = NaiveDate::from_ymd_opt(2014, 11, 28).unwrap().and_hms_nano_opt(12, 0, 9, 1).unwrap().and_local_timezone(Utc).unwrap(); |
| //! assert_eq!(format!("{:?}", dt_nano), "2014-11-28T12:00:09.000000001Z"); |
| //! # } |
| //! # #[cfg(not(feature = "unstable-locales"))] |
| //! # fn test() {} |
| //! # if cfg!(feature = "unstable-locales") { |
| //! # test(); |
| //! # } |
| //! ``` |
| //! |
| //! Parsing can be done with three methods: |
| //! |
| //! 1. The standard [`FromStr`](https://doc.rust-lang.org/std/str/trait.FromStr.html) trait |
| //! (and [`parse`](https://doc.rust-lang.org/std/primitive.str.html#method.parse) method |
| //! on a string) can be used for parsing `DateTime<FixedOffset>`, `DateTime<Utc>` and |
| //! `DateTime<Local>` values. This parses what the `{:?}` |
| //! ([`std::fmt::Debug`](https://doc.rust-lang.org/std/fmt/trait.Debug.html)) |
| //! format specifier prints, and requires the offset to be present. |
| //! |
| //! 2. [`DateTime::parse_from_str`](./struct.DateTime.html#method.parse_from_str) parses |
| //! a date and time with offsets and returns `DateTime<FixedOffset>`. |
| //! This should be used when the offset is a part of input and the caller cannot guess that. |
| //! It *cannot* be used when the offset can be missing. |
| //! [`DateTime::parse_from_rfc2822`](./struct.DateTime.html#method.parse_from_rfc2822) |
| //! and |
| //! [`DateTime::parse_from_rfc3339`](./struct.DateTime.html#method.parse_from_rfc3339) |
| //! are similar but for well-known formats. |
| //! |
| //! 3. [`Offset::datetime_from_str`](./offset/trait.TimeZone.html#method.datetime_from_str) is |
| //! similar but returns `DateTime` of given offset. |
| //! When the explicit offset is missing from the input, it simply uses given offset. |
| //! It issues an error when the input contains an explicit offset different |
| //! from the current offset. |
| //! |
| //! More detailed control over the parsing process is available via |
| //! [`format`](./format/index.html) module. |
| //! |
| //! ```rust |
| //! use chrono::prelude::*; |
| //! |
| //! let dt = Utc.with_ymd_and_hms(2014, 11, 28, 12, 0, 9).unwrap(); |
| //! let fixed_dt = dt.with_timezone(&FixedOffset::east_opt(9*3600).unwrap()); |
| //! |
| //! // method 1 |
| //! assert_eq!("2014-11-28T12:00:09Z".parse::<DateTime<Utc>>(), Ok(dt.clone())); |
| //! assert_eq!("2014-11-28T21:00:09+09:00".parse::<DateTime<Utc>>(), Ok(dt.clone())); |
| //! assert_eq!("2014-11-28T21:00:09+09:00".parse::<DateTime<FixedOffset>>(), Ok(fixed_dt.clone())); |
| //! |
| //! // method 2 |
| //! assert_eq!(DateTime::parse_from_str("2014-11-28 21:00:09 +09:00", "%Y-%m-%d %H:%M:%S %z"), |
| //! Ok(fixed_dt.clone())); |
| //! assert_eq!(DateTime::parse_from_rfc2822("Fri, 28 Nov 2014 21:00:09 +0900"), |
| //! Ok(fixed_dt.clone())); |
| //! assert_eq!(DateTime::parse_from_rfc3339("2014-11-28T21:00:09+09:00"), Ok(fixed_dt.clone())); |
| //! |
| //! // method 3 |
| //! assert_eq!(Utc.datetime_from_str("2014-11-28 12:00:09", "%Y-%m-%d %H:%M:%S"), Ok(dt.clone())); |
| //! assert_eq!(Utc.datetime_from_str("Fri Nov 28 12:00:09 2014", "%a %b %e %T %Y"), Ok(dt.clone())); |
| //! |
| //! // oops, the year is missing! |
| //! assert!(Utc.datetime_from_str("Fri Nov 28 12:00:09", "%a %b %e %T %Y").is_err()); |
| //! // oops, the format string does not include the year at all! |
| //! assert!(Utc.datetime_from_str("Fri Nov 28 12:00:09", "%a %b %e %T").is_err()); |
| //! // oops, the weekday is incorrect! |
| //! assert!(Utc.datetime_from_str("Sat Nov 28 12:00:09 2014", "%a %b %e %T %Y").is_err()); |
| //! ``` |
| //! |
| //! Again : See [`format::strftime`](./format/strftime/index.html#specifiers) |
| //! documentation for full syntax and list of specifiers. |
| //! |
| //! ### Conversion from and to EPOCH timestamps |
| //! |
| //! Use [`Utc.timestamp(seconds, nanoseconds)`](./offset/trait.TimeZone.html#method.timestamp) |
| //! to construct a [`DateTime<Utc>`](./struct.DateTime.html) from a UNIX timestamp |
| //! (seconds, nanoseconds that passed since January 1st 1970). |
| //! |
| //! Use [`DateTime.timestamp`](./struct.DateTime.html#method.timestamp) to get the timestamp (in seconds) |
| //! from a [`DateTime`](./struct.DateTime.html). Additionally, you can use |
| //! [`DateTime.timestamp_subsec_nanos`](./struct.DateTime.html#method.timestamp_subsec_nanos) |
| //! to get the number of additional number of nanoseconds. |
| //! |
| </span><span class="attribute">#![cfg_attr(not(feature = <span class="string">"std"</span>), doc = <span class="string">"```ignore"</span>)] |
| #![cfg_attr(feature = <span class="string">"std"</span>, doc = <span class="string">"```rust"</span>)] |
| </span><span class="doccomment">//! // We need the trait in scope to use Utc::timestamp(). |
| //! use chrono::{DateTime, TimeZone, Utc}; |
| //! |
| //! // Construct a datetime from epoch: |
| //! let dt = Utc.timestamp_opt(1_500_000_000, 0).unwrap(); |
| //! assert_eq!(dt.to_rfc2822(), "Fri, 14 Jul 2017 02:40:00 +0000"); |
| //! |
| //! // Get epoch value from a datetime: |
| //! let dt = DateTime::parse_from_rfc2822("Fri, 14 Jul 2017 02:40:00 +0000").unwrap(); |
| //! assert_eq!(dt.timestamp(), 1_500_000_000); |
| //! ``` |
| //! |
| //! ### Naive date and time |
| //! |
| //! Chrono provides naive counterparts to `Date`, (non-existent) `Time` and `DateTime` |
| //! as [**`NaiveDate`**](./naive/struct.NaiveDate.html), |
| //! [**`NaiveTime`**](./naive/struct.NaiveTime.html) and |
| //! [**`NaiveDateTime`**](./naive/struct.NaiveDateTime.html) respectively. |
| //! |
| //! They have almost equivalent interfaces as their timezone-aware twins, |
| //! but are not associated to time zones obviously and can be quite low-level. |
| //! They are mostly useful for building blocks for higher-level types. |
| //! |
| //! Timezone-aware `DateTime` and `Date` types have two methods returning naive versions: |
| //! [`naive_local`](./struct.DateTime.html#method.naive_local) returns |
| //! a view to the naive local time, |
| //! and [`naive_utc`](./struct.DateTime.html#method.naive_utc) returns |
| //! a view to the naive UTC time. |
| //! |
| //! ## Limitations |
| //! |
| //! Only proleptic Gregorian calendar (i.e. extended to support older dates) is supported. |
| //! Be very careful if you really have to deal with pre-20C dates, they can be in Julian or others. |
| //! |
| //! Date types are limited in about +/- 262,000 years from the common epoch. |
| //! Time types are limited in the nanosecond accuracy. |
| //! |
| //! [Leap seconds are supported in the representation but |
| //! Chrono doesn't try to make use of them](./naive/struct.NaiveTime.html#leap-second-handling). |
| //! (The main reason is that leap seconds are not really predictable.) |
| //! Almost *every* operation over the possible leap seconds will ignore them. |
| //! Consider using `NaiveDateTime` with the implicit TAI (International Atomic Time) scale |
| //! if you want. |
| //! |
| //! Chrono inherently does not support an inaccurate or partial date and time representation. |
| //! Any operation that can be ambiguous will return `None` in such cases. |
| //! For example, "a month later" of 2014-01-30 is not well-defined |
| //! and consequently `Utc.ymd_opt(2014, 1, 30).unwrap().with_month(2)` returns `None`. |
| //! |
| //! Non ISO week handling is not yet supported. |
| //! For now you can use the [chrono_ext](https://crates.io/crates/chrono_ext) |
| //! crate ([sources](https://github.com/bcourtine/chrono-ext/)). |
| //! |
| //! Advanced time zone handling is not yet supported. |
| //! For now you can try the [Chrono-tz](https://github.com/chronotope/chrono-tz/) crate instead. |
| |
| </span><span class="attribute">#![doc(html_root_url = <span class="string">"https://docs.rs/chrono/latest/"</span>, test(attr(deny(warnings))))] |
| #![cfg_attr(feature = <span class="string">"bench"</span>, feature(test))] </span><span class="comment">// lib stability features as per RFC #507 |
| </span><span class="attribute">#![deny(missing_docs)] |
| #![deny(missing_debug_implementations)] |
| #![warn(unreachable_pub)] |
| #![deny(dead_code)] |
| #![cfg_attr(not(any(feature = <span class="string">"std"</span>, test)), no_std)] |
| </span><span class="comment">// can remove this if/when rustc-serialize support is removed |
| // keeps clippy happy in the meantime |
| </span><span class="attribute">#![cfg_attr(feature = <span class="string">"rustc-serialize"</span>, allow(deprecated))] |
| #![cfg_attr(docsrs, feature(doc_cfg))] |
| |
| #[cfg(feature = <span class="string">"oldtime"</span>)] |
| #[cfg_attr(docsrs, doc(cfg(feature = <span class="string">"oldtime"</span>)))] |
| </span><span class="kw">extern crate </span>time <span class="kw">as </span>oldtime; |
| <span class="attribute">#[cfg(not(feature = <span class="string">"oldtime"</span>))] |
| </span><span class="kw">mod </span>oldtime; |
| <span class="comment">// this reexport is to aid the transition and should not be in the prelude! |
| </span><span class="kw">pub use </span>oldtime::{Duration, OutOfRangeError}; |
| |
| <span class="kw">use </span>core::fmt; |
| |
| <span class="attribute">#[cfg(feature = <span class="string">"__doctest"</span>)] |
| #[cfg_attr(feature = <span class="string">"__doctest"</span>, cfg(doctest))] |
| </span><span class="kw">use </span>doc_comment::doctest; |
| |
| <span class="attribute">#[cfg(feature = <span class="string">"__doctest"</span>)] |
| #[cfg_attr(feature = <span class="string">"__doctest"</span>, cfg(doctest))] |
| </span><span class="macro">doctest!</span>(<span class="string">"../README.md"</span>); |
| |
| <span class="doccomment">/// A convenience module appropriate for glob imports (`use chrono::prelude::*;`). |
| </span><span class="kw">pub mod </span>prelude { |
| <span class="attribute">#[doc(no_inline)] |
| #[allow(deprecated)] |
| </span><span class="kw">pub use </span><span class="kw">crate</span>::Date; |
| <span class="attribute">#[cfg(feature = <span class="string">"clock"</span>)] |
| #[cfg_attr(docsrs, doc(cfg(feature = <span class="string">"clock"</span>)))] |
| #[doc(no_inline)] |
| </span><span class="kw">pub use </span><span class="kw">crate</span>::Local; |
| <span class="attribute">#[cfg(feature = <span class="string">"unstable-locales"</span>)] |
| #[cfg_attr(docsrs, doc(cfg(feature = <span class="string">"unstable-locales"</span>)))] |
| #[doc(no_inline)] |
| </span><span class="kw">pub use </span><span class="kw">crate</span>::Locale; |
| <span class="attribute">#[doc(no_inline)] |
| </span><span class="kw">pub use </span><span class="kw">crate</span>::SubsecRound; |
| <span class="attribute">#[doc(no_inline)] |
| </span><span class="kw">pub use crate</span>::{DateTime, SecondsFormat}; |
| <span class="attribute">#[doc(no_inline)] |
| </span><span class="kw">pub use crate</span>::{Datelike, Month, Timelike, Weekday}; |
| <span class="attribute">#[doc(no_inline)] |
| </span><span class="kw">pub use crate</span>::{FixedOffset, Utc}; |
| <span class="attribute">#[doc(no_inline)] |
| </span><span class="kw">pub use crate</span>::{NaiveDate, NaiveDateTime, NaiveTime}; |
| <span class="attribute">#[doc(no_inline)] |
| </span><span class="kw">pub use crate</span>::{Offset, TimeZone}; |
| } |
| |
| <span class="kw">mod </span>date; |
| <span class="attribute">#[allow(deprecated)] |
| </span><span class="kw">pub use </span>date::{Date, MAX_DATE, MIN_DATE}; |
| |
| <span class="kw">mod </span>datetime; |
| <span class="attribute">#[cfg(feature = <span class="string">"rustc-serialize"</span>)] |
| #[cfg_attr(docsrs, doc(cfg(feature = <span class="string">"rustc-serialize"</span>)))] |
| </span><span class="kw">pub use </span>datetime::rustc_serialize::TsSeconds; |
| <span class="attribute">#[allow(deprecated)] |
| </span><span class="kw">pub use </span>datetime::{DateTime, SecondsFormat, MAX_DATETIME, MIN_DATETIME}; |
| |
| <span class="kw">pub mod </span>format; |
| <span class="doccomment">/// L10n locales. |
| </span><span class="attribute">#[cfg(feature = <span class="string">"unstable-locales"</span>)] |
| #[cfg_attr(docsrs, doc(cfg(feature = <span class="string">"unstable-locales"</span>)))] |
| </span><span class="kw">pub use </span>format::Locale; |
| <span class="kw">pub use </span>format::{ParseError, ParseResult}; |
| |
| <span class="kw">pub mod </span>naive; |
| <span class="attribute">#[doc(no_inline)] |
| </span><span class="kw">pub use </span>naive::{Days, IsoWeek, NaiveDate, NaiveDateTime, NaiveTime, NaiveWeek}; |
| |
| <span class="kw">pub mod </span>offset; |
| <span class="attribute">#[cfg(feature = <span class="string">"clock"</span>)] |
| #[cfg_attr(docsrs, doc(cfg(feature = <span class="string">"clock"</span>)))] |
| #[doc(no_inline)] |
| </span><span class="kw">pub use </span>offset::Local; |
| <span class="attribute">#[doc(no_inline)] |
| </span><span class="kw">pub use </span>offset::{FixedOffset, LocalResult, Offset, TimeZone, Utc}; |
| |
| <span class="kw">mod </span>round; |
| <span class="kw">pub use </span>round::{DurationRound, RoundingError, SubsecRound}; |
| |
| <span class="kw">mod </span>weekday; |
| <span class="kw">pub use </span>weekday::{ParseWeekdayError, Weekday}; |
| |
| <span class="kw">mod </span>month; |
| <span class="kw">pub use </span>month::{Month, Months, ParseMonthError}; |
| |
| <span class="kw">mod </span>traits; |
| <span class="kw">pub use </span>traits::{Datelike, Timelike}; |
| |
| <span class="attribute">#[cfg(feature = <span class="string">"__internal_bench"</span>)] |
| #[doc(hidden)] |
| </span><span class="kw">pub use </span>naive::__BenchYearFlags; |
| |
| <span class="doccomment">/// Serialization/Deserialization with serde. |
| /// |
| /// This module provides default implementations for `DateTime` using the [RFC 3339][1] format and various |
| /// alternatives for use with serde's [`with` annotation][2]. |
| /// |
| /// *Available on crate feature 'serde' only.* |
| /// |
| /// [1]: https://tools.ietf.org/html/rfc3339 |
| /// [2]: https://serde.rs/field-attrs.html#with |
| </span><span class="attribute">#[cfg(feature = <span class="string">"serde"</span>)] |
| #[cfg_attr(docsrs, doc(cfg(feature = <span class="string">"serde"</span>)))] |
| </span><span class="kw">pub mod </span>serde { |
| <span class="kw">pub use </span><span class="kw">super</span>::datetime::serde::<span class="kw-2">*</span>; |
| } |
| |
| <span class="doccomment">/// Out of range error type used in various converting APIs |
| </span><span class="attribute">#[derive(Clone, Copy, Hash, PartialEq, Eq)] |
| </span><span class="kw">pub struct </span>OutOfRange { |
| _private: (), |
| } |
| |
| <span class="kw">impl </span>OutOfRange { |
| <span class="kw">const fn </span>new() -> OutOfRange { |
| OutOfRange { _private: () } |
| } |
| } |
| |
| <span class="kw">impl </span>fmt::Display <span class="kw">for </span>OutOfRange { |
| <span class="kw">fn </span>fmt(<span class="kw-2">&</span><span class="self">self</span>, f: <span class="kw-2">&mut </span>fmt::Formatter) -> fmt::Result { |
| <span class="macro">write!</span>(f, <span class="string">"out of range"</span>) |
| } |
| } |
| |
| <span class="kw">impl </span>fmt::Debug <span class="kw">for </span>OutOfRange { |
| <span class="kw">fn </span>fmt(<span class="kw-2">&</span><span class="self">self</span>, f: <span class="kw-2">&mut </span>fmt::Formatter) -> fmt::Result { |
| <span class="macro">write!</span>(f, <span class="string">"out of range"</span>) |
| } |
| } |
| |
| <span class="attribute">#[cfg(feature = <span class="string">"std"</span>)] |
| </span><span class="kw">impl </span>std::error::Error <span class="kw">for </span>OutOfRange {} |
| </code></pre></div> |
| </section></div></main><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono" data-themes="ayu,dark,light" data-resource-suffix="" data-rustdoc-version="1.66.0-nightly (5c8bff74b 2022-10-21)" ></div></body></html> |