Initial docs commit
This commit is contained in:
Uttarayan Mondal
@@ -0,0 +1,6 @@
|
||||
<!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="The maximum possible `NaiveDate` (December 31, 262143 CE)."><meta name="keywords" content="rust, rustlang, rust-lang, MAX_DATE"><title>chrono::naive::MAX_DATE - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc constant"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><div class="sidebar-elems"><p class="location"><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></p><div id="sidebar-vars" data-name="MAX_DATE" data-ty="constant" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Constant <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="constant" href="">MAX_DATE</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/date.rs.html#106" title="goto source code">[src]</a></span></h1><pre class="rust const">pub const MAX_DATE: <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>;</pre><div class="docblock"><p>The maximum possible <code>NaiveDate</code> (December 31, 262143 CE).</p>
|
||||
</div></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,6 @@
|
||||
<!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="The maximum possible `NaiveDateTime`."><meta name="keywords" content="rust, rustlang, rust-lang, MAX_DATETIME"><title>chrono::naive::MAX_DATETIME - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc constant"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><div class="sidebar-elems"><p class="location"><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></p><div id="sidebar-vars" data-name="MAX_DATETIME" data-ty="constant" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Constant <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="constant" href="">MAX_DATETIME</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#34" title="goto source code">[src]</a></span></h1><pre class="rust const">pub const MAX_DATETIME: <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>;</pre><div class="docblock"><p>The maximum possible <code>NaiveDateTime</code>.</p>
|
||||
</div></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,6 @@
|
||||
<!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="The minimum possible `NaiveDate` (January 1, 262145 BCE)."><meta name="keywords" content="rust, rustlang, rust-lang, MIN_DATE"><title>chrono::naive::MIN_DATE - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc constant"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><div class="sidebar-elems"><p class="location"><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></p><div id="sidebar-vars" data-name="MIN_DATE" data-ty="constant" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Constant <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="constant" href="">MIN_DATE</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/date.rs.html#104" title="goto source code">[src]</a></span></h1><pre class="rust const">pub const MIN_DATE: <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>;</pre><div class="docblock"><p>The minimum possible <code>NaiveDate</code> (January 1, 262145 BCE).</p>
|
||||
</div></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,6 @@
|
||||
<!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="The minimum possible `NaiveDateTime`."><meta name="keywords" content="rust, rustlang, rust-lang, MIN_DATETIME"><title>chrono::naive::MIN_DATETIME - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc constant"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><div class="sidebar-elems"><p class="location"><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></p><div id="sidebar-vars" data-name="MIN_DATETIME" data-ty="constant" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Constant <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="constant" href="">MIN_DATETIME</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#32" title="goto source code">[src]</a></span></h1><pre class="rust const">pub const MIN_DATETIME: <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>;</pre><div class="docblock"><p>The minimum possible <code>NaiveDateTime</code>.</p>
|
||||
</div></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,10 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0;URL=../../../chrono/naive/constant.MAX_DATE.html">
|
||||
</head>
|
||||
<body>
|
||||
<p>Redirecting to <a href="../../../chrono/naive/constant.MAX_DATE.html">../../../chrono/naive/constant.MAX_DATE.html</a>...</p>
|
||||
<script>location.replace("../../../chrono/naive/constant.MAX_DATE.html" + location.search + location.hash);</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,10 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0;URL=../../../chrono/naive/constant.MIN_DATE.html">
|
||||
</head>
|
||||
<body>
|
||||
<p>Redirecting to <a href="../../../chrono/naive/constant.MIN_DATE.html">../../../chrono/naive/constant.MIN_DATE.html</a>...</p>
|
||||
<script>location.replace("../../../chrono/naive/constant.MIN_DATE.html" + location.search + location.hash);</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,10 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0;URL=../../../chrono/naive/struct.NaiveDate.html">
|
||||
</head>
|
||||
<body>
|
||||
<p>Redirecting to <a href="../../../chrono/naive/struct.NaiveDate.html">../../../chrono/naive/struct.NaiveDate.html</a>...</p>
|
||||
<script>location.replace("../../../chrono/naive/struct.NaiveDate.html" + location.search + location.hash);</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,10 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0;URL=../../../chrono/naive/constant.MAX_DATETIME.html">
|
||||
</head>
|
||||
<body>
|
||||
<p>Redirecting to <a href="../../../chrono/naive/constant.MAX_DATETIME.html">../../../chrono/naive/constant.MAX_DATETIME.html</a>...</p>
|
||||
<script>location.replace("../../../chrono/naive/constant.MAX_DATETIME.html" + location.search + location.hash);</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,10 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0;URL=../../../chrono/naive/constant.MIN_DATETIME.html">
|
||||
</head>
|
||||
<body>
|
||||
<p>Redirecting to <a href="../../../chrono/naive/constant.MIN_DATETIME.html">../../../chrono/naive/constant.MIN_DATETIME.html</a>...</p>
|
||||
<script>location.replace("../../../chrono/naive/constant.MIN_DATETIME.html" + location.search + location.hash);</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,10 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0;URL=../../../chrono/naive/struct.NaiveDateTime.html">
|
||||
</head>
|
||||
<body>
|
||||
<p>Redirecting to <a href="../../../chrono/naive/struct.NaiveDateTime.html">../../../chrono/naive/struct.NaiveDateTime.html</a>...</p>
|
||||
<script>location.replace("../../../chrono/naive/struct.NaiveDateTime.html" + location.search + location.hash);</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,23 @@
|
||||
<!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="Date and time types unconcerned with timezones."><meta name="keywords" content="rust, rustlang, rust-lang, naive"><title>chrono::naive - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc mod"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><p class="location">Module naive</p><div class="sidebar-elems"><div class="block items"><ul><li><a href="#structs">Structs</a></li><li><a href="#constants">Constants</a></li></ul></div><p class="location"><a href="../index.html">chrono</a></p><div id="sidebar-vars" data-name="naive" data-ty="mod" data-relpath="../"></div><script defer src="../sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Module <a href="../index.html">chrono</a>::<wbr><a class="mod" href="">naive</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/lib.rs.html#541-578" title="goto source code">[src]</a></span></h1><div class="docblock"><p>Date and time types unconcerned with timezones.</p>
|
||||
<p>They are primarily building blocks for other types
|
||||
(e.g. <a href="../offset/trait.TimeZone.html"><code>TimeZone</code></a>),
|
||||
but can be also used for the simpler date and time handling.</p>
|
||||
</div><h2 id="structs" class="section-header"><a href="#structs">Structs</a></h2>
|
||||
<table><tr class="module-item"><td><a class="struct" href="struct.IsoWeek.html" title="chrono::naive::IsoWeek struct">IsoWeek</a></td><td class="docblock-short"><p>ISO 8601 week.</p>
|
||||
</td></tr><tr class="module-item"><td><a class="struct" href="struct.NaiveDate.html" title="chrono::naive::NaiveDate struct">NaiveDate</a></td><td class="docblock-short"><p>ISO 8601 calendar date without timezone.
|
||||
Allows for every <a href="#calendar-date">proleptic Gregorian date</a>
|
||||
from Jan 1, 262145 BCE to Dec 31, 262143 CE.
|
||||
Also supports the conversion from ISO 8601 ordinal and week date.</p>
|
||||
</td></tr><tr class="module-item"><td><a class="struct" href="struct.NaiveDateTime.html" title="chrono::naive::NaiveDateTime struct">NaiveDateTime</a></td><td class="docblock-short"><p>ISO 8601 combined date and time without timezone.</p>
|
||||
</td></tr><tr class="module-item"><td><a class="struct" href="struct.NaiveTime.html" title="chrono::naive::NaiveTime struct">NaiveTime</a></td><td class="docblock-short"><p>ISO 8601 time without timezone.
|
||||
Allows for the nanosecond precision and optional leap second representation.</p>
|
||||
</td></tr></table><h2 id="constants" class="section-header"><a href="#constants">Constants</a></h2>
|
||||
<table><tr class="module-item"><td><a class="constant" href="constant.MAX_DATE.html" title="chrono::naive::MAX_DATE constant">MAX_DATE</a></td><td class="docblock-short"><p>The maximum possible <code>NaiveDate</code> (December 31, 262143 CE).</p>
|
||||
</td></tr><tr class="module-item"><td><a class="constant" href="constant.MAX_DATETIME.html" title="chrono::naive::MAX_DATETIME constant">MAX_DATETIME</a></td><td class="docblock-short"><p>The maximum possible <code>NaiveDateTime</code>.</p>
|
||||
</td></tr><tr class="module-item"><td><a class="constant" href="constant.MIN_DATE.html" title="chrono::naive::MIN_DATE constant">MIN_DATE</a></td><td class="docblock-short"><p>The minimum possible <code>NaiveDate</code> (January 1, 262145 BCE).</p>
|
||||
</td></tr><tr class="module-item"><td><a class="constant" href="constant.MIN_DATETIME.html" title="chrono::naive::MIN_DATETIME constant">MIN_DATETIME</a></td><td class="docblock-short"><p>The minimum possible <code>NaiveDateTime</code>.</p>
|
||||
</td></tr></table></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,10 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0;URL=../../../chrono/naive/struct.IsoWeek.html">
|
||||
</head>
|
||||
<body>
|
||||
<p>Redirecting to <a href="../../../chrono/naive/struct.IsoWeek.html">../../../chrono/naive/struct.IsoWeek.html</a>...</p>
|
||||
<script>location.replace("../../../chrono/naive/struct.IsoWeek.html" + location.search + location.hash);</script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1 @@
|
||||
initSidebarItems({"constant":[["MAX_DATE","The maximum possible `NaiveDate` (December 31, 262143 CE)."],["MAX_DATETIME","The maximum possible `NaiveDateTime`."],["MIN_DATE","The minimum possible `NaiveDate` (January 1, 262145 BCE)."],["MIN_DATETIME","The minimum possible `NaiveDateTime`."]],"struct":[["IsoWeek","ISO 8601 week."],["NaiveDate","ISO 8601 calendar date without timezone. Allows for every proleptic Gregorian date from Jan 1, 262145 BCE to Dec 31, 262143 CE. Also supports the conversion from ISO 8601 ordinal and week date."],["NaiveDateTime","ISO 8601 combined date and time without timezone."],["NaiveTime","ISO 8601 time without timezone. Allows for the nanosecond precision and optional leap second representation."]]});
|
||||
@@ -0,0 +1,84 @@
|
||||
<!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 week."><meta name="keywords" content="rust, rustlang, rust-lang, IsoWeek"><title>chrono::naive::IsoWeek - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc struct"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><p class="location">Struct IsoWeek</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#implementations">Methods</a><div class="sidebar-links"><a href="#method.week">week</a><a href="#method.week0">week0</a><a href="#method.year">year</a></div><a class="sidebar-title" href="#trait-implementations">Trait Implementations</a><div class="sidebar-links"><a href="#impl-Clone">Clone</a><a href="#impl-Copy">Copy</a><a href="#impl-Debug">Debug</a><a href="#impl-Eq">Eq</a><a href="#impl-Ord">Ord</a><a href="#impl-PartialEq%3CIsoWeek%3E">PartialEq<IsoWeek></a><a href="#impl-PartialOrd%3CIsoWeek%3E">PartialOrd<IsoWeek></a><a href="#impl-StructuralEq">StructuralEq</a><a href="#impl-StructuralPartialEq">StructuralPartialEq</a></div><a class="sidebar-title" href="#synthetic-implementations">Auto Trait Implementations</a><div class="sidebar-links"><a href="#impl-RefUnwindSafe">RefUnwindSafe</a><a href="#impl-Send">Send</a><a href="#impl-Sync">Sync</a><a href="#impl-Unpin">Unpin</a><a href="#impl-UnwindSafe">UnwindSafe</a></div><a class="sidebar-title" href="#blanket-implementations">Blanket Implementations</a><div class="sidebar-links"><a href="#impl-Any">Any</a><a href="#impl-Borrow%3CT%3E">Borrow<T></a><a href="#impl-BorrowMut%3CT%3E">BorrowMut<T></a><a href="#impl-From%3CT%3E">From<T></a><a href="#impl-Into%3CU%3E">Into<U></a><a href="#impl-ToOwned">ToOwned</a><a href="#impl-TryFrom%3CU%3E">TryFrom<U></a><a href="#impl-TryInto%3CU%3E">TryInto<U></a></div></div><p class="location"><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></p><div id="sidebar-vars" data-name="IsoWeek" data-ty="struct" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Struct <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="struct" href="">IsoWeek</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#17-22" title="goto source code">[src]</a></span></h1><div class="docblock type-decl hidden-by-usual-hider"><pre class="rust struct">pub struct IsoWeek { /* fields omitted */ }</pre></div><div class="docblock"><p>ISO 8601 week.</p>
|
||||
<p>This type, combined with <a href="../enum.Weekday.html"><code>Weekday</code></a>,
|
||||
constitues the ISO 8601 <a href="./struct.NaiveDate.html#week-date">week date</a>.
|
||||
One can retrieve this type from the existing <a href="../trait.Datelike.html"><code>Datelike</code></a> types
|
||||
via the <a href="../trait.Datelike.html#tymethod.iso_week"><code>Datelike::iso_week</code></a> method.</p>
|
||||
</div><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><h3 id="impl" class="impl"><code class="in-band">impl <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#48-107" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.year" class="method"><code>pub fn <a href="#method.year" class="fnname">year</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#70-72" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the year number for this ISO week.</p>
|
||||
<h1 id="example" class="section-header"><a href="#example">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_isoywd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);</pre></div>
|
||||
<p>This year number might not match the calendar year number.
|
||||
Continuing the example…</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2014</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">29</span>));</pre></div>
|
||||
</div><h4 id="method.week" class="method"><code>pub fn <a href="#method.week" class="fnname">week</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#87-89" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the ISO week number starting from 1.</p>
|
||||
<p>The return value ranges from 1 to 53. (The last week of year differs by years.)</p>
|
||||
<h1 id="example-1" class="section-header"><a href="#example-1">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_isoywd</span>(<span class="number">2015</span>, <span class="number">15</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">15</span>);</pre></div>
|
||||
</div><h4 id="method.week0" class="method"><code>pub fn <a href="#method.week0" class="fnname">week0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#104-106" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the ISO week number starting from 0.</p>
|
||||
<p>The return value ranges from 0 to 52. (The last week of year differs by years.)</p>
|
||||
<h1 id="example-2" class="section-header"><a href="#example-2">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_isoywd</span>(<span class="number">2015</span>, <span class="number">15</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week0</span>(), <span class="number">14</span>);</pre></div>
|
||||
</div></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><h3 id="impl-Clone" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-Clone" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.clone" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone" class="fnname">clone</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns a copy of the value. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone">Read more</a></p>
|
||||
</div><h4 id="method.clone_from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from" class="fnname">clone_from</a>(&mut self, source: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Self)</code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/clone.rs.html#128" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from">Read more</a></p>
|
||||
</div></div><h3 id="impl-Copy" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Copy.html" title="trait core::marker::Copy">Copy</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-Copy" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-Debug" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-Debug" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#130-141" title="goto source code">[src]</a></h3><div class="docblock"><p>The <code>Debug</code> output of the ISO week <code>w</code> is the same as
|
||||
<a href="../format/strftime/index.html"><code>d.format("%G-W%V")</code></a>
|
||||
where <code>d</code> is any <code>NaiveDate</code> value in that week.</p>
|
||||
<h1 id="example-3" class="section-header"><a href="#example-3">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).<span class="ident">iso_week</span>()), <span class="string">"2015-W36"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>( <span class="number">0</span>, <span class="number">1</span>, <span class="number">3</span>).<span class="ident">iso_week</span>()), <span class="string">"0000-W01"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">9999</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">iso_week</span>()), <span class="string">"9999-W52"</span>);</pre></div>
|
||||
<p>ISO 8601 requires an explicit sign for years before 1 BCE or after 9999 CE.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>( <span class="number">0</span>, <span class="number">1</span>, <span class="number">2</span>).<span class="ident">iso_week</span>()), <span class="string">"-0001-W52"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">10000</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">iso_week</span>()), <span class="string">"+10000-W52"</span>);</pre></div>
|
||||
</div><div class="impl-items"><h4 id="method.fmt" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/nightly/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#131-140" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></p>
|
||||
</div></div><h3 id="impl-Eq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-Eq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-Ord" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html" title="trait core::cmp::Ord">Ord</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-Ord" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.cmp" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#tymethod.cmp" class="fnname">cmp</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method returns an <a href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="Ordering"><code>Ordering</code></a> between <code>self</code> and <code>other</code>. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#tymethod.cmp">Read more</a></p>
|
||||
</div><h4 id="method.max" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.max" class="fnname">max</a>(self, other: Self) -> Self</code><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#723-725" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Compares and returns the maximum of two values. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.max">Read more</a></p>
|
||||
</div><h4 id="method.min" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.min" class="fnname">min</a>(self, other: Self) -> Self</code><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#743-745" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Compares and returns the minimum of two values. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.min">Read more</a></p>
|
||||
</div><h4 id="method.clamp" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.clamp" class="fnname">clamp</a>(self, min: Self, max: Self) -> Self</code><span class="since" title="Stable since Rust version 1.50.0">1.50.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#768-770" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Restrict a value to a certain interval. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.clamp">Read more</a></p>
|
||||
</div></div><h3 id="impl-PartialEq%3CIsoWeek%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html" title="trait core::cmp::PartialEq">PartialEq</a><<a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a>> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-PartialEq%3CIsoWeek%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.eq" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#tymethod.eq" class="fnname">eq</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
|
||||
by <code>==</code>. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#tymethod.eq">Read more</a></p>
|
||||
</div><h4 id="method.ne" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#method.ne" class="fnname">ne</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests for <code>!=</code>.</p>
|
||||
</div></div><h3 id="impl-PartialOrd%3CIsoWeek%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a><<a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a>> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-PartialOrd%3CIsoWeek%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.partial_cmp" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp" class="fnname">partial_cmp</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="enum" href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a>></code><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp">Read more</a></p>
|
||||
</div><h4 id="method.lt" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.lt" class="fnname">lt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#963" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code><</code> operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.lt">Read more</a></p>
|
||||
</div><h4 id="method.le" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.le" class="fnname">le</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#982" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code><=</code>
|
||||
operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.le">Read more</a></p>
|
||||
</div><h4 id="method.gt" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.gt" class="fnname">gt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#1000" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>></code> operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.gt">Read more</a></p>
|
||||
</div><h4 id="method.ge" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.ge" class="fnname">ge</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#1019" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>>=</code>
|
||||
operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.ge">Read more</a></p>
|
||||
</div></div><h3 id="impl-StructuralEq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.StructuralEq.html" title="trait core::marker::StructuralEq">StructuralEq</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-StructuralEq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-StructuralPartialEq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.StructuralPartialEq.html" title="trait core::marker::StructuralPartialEq">StructuralPartialEq</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-StructuralPartialEq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/isoweek.rs.html#16" title="goto source code">[src]</a></h3><div class="impl-items"></div></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><h3 id="impl-RefUnwindSafe" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/std/panic/trait.RefUnwindSafe.html" title="trait std::panic::RefUnwindSafe">RefUnwindSafe</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-RefUnwindSafe" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Send" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-Send" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Sync" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-Sync" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Unpin" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-Unpin" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-UnwindSafe" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html" title="trait std::panic::UnwindSafe">UnwindSafe</a> for <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a href="#impl-UnwindSafe" class="anchor"></a></h3><div class="impl-items"></div></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><h3 id="impl-Any" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T <span class="where fmt-newline">where<br> T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-Any" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#131-135" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.type_id" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html#tymethod.type_id" class="fnname">type_id</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/nightly/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#132" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html#tymethod.type_id">Read more</a></p>
|
||||
</div></div><h3 id="impl-Borrow%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-Borrow%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#207-211" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.borrow" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html#tymethod.borrow" class="fnname">borrow</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#208" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></p>
|
||||
</div></div><h3 id="impl-BorrowMut%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-BorrowMut%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#214-218" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.borrow_mut" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fnname">borrow_mut</a>(&mut self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#215" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></p>
|
||||
</div></div><h3 id="impl-From%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for T</code><a href="#impl-From%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#545-549" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html#tymethod.from" class="fnname">from</a>(t: T) -> T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#546" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-Into%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html" title="trait core::convert::From">From</a><T>, </span></code><a href="#impl-Into%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#534-541" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html#tymethod.into" class="fnname">into</a>(self) -> U</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#538" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-ToOwned" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>, </span></code><a href="#impl-ToOwned" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#81-93" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Owned" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="type">Owned</a> = T</code></h4><div class='docblock'><p>The resulting type after obtaining ownership.</p>
|
||||
</div><h4 id="method.to_owned" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fnname">to_owned</a>(&self) -> T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#86" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></p>
|
||||
</div><h4 id="method.clone_into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fnname">clone_into</a>(&self, target: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>T)</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#90" title="goto source code">[src]</a></h4><div class="item-info hidden"><div class="stab unstable"><details><summary><span class="emoji">🔬</span> This is a nightly-only experimental API. (<code>toowned_clone_into</code>)</summary><p>recently added</p>
|
||||
</details></div></div><div class='docblock hidden'><p>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></p>
|
||||
</div></div><h3 id="impl-TryFrom%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><T>, </span></code><a href="#impl-TryFrom%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#582-591" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Error" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" class="type">Error</a> = <a class="enum" href="https://doc.rust-lang.org/nightly/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></code></h4><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||||
</div><h4 id="method.try_from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#tymethod.try_from" class="fnname">try_from</a>(value: U) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a><T, <T as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#588" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-TryInto%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>, </span></code><a href="#impl-TryInto%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#568-577" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Error-1" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html#associatedtype.Error" class="type">Error</a> = <U as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></code></h4><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||||
</div><h4 id="method.try_into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html#tymethod.try_into" class="fnname">try_into</a>(self) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a><U, <U as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#574" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div></div></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,900 @@
|
||||
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="ISO 8601 calendar date without timezone. Allows for every proleptic Gregorian date from Jan 1, 262145 BCE to Dec 31, 262143 CE. Also supports the conversion from ISO 8601 ordinal and week date."><meta name="keywords" content="rust, rustlang, rust-lang, NaiveDate"><title>chrono::naive::NaiveDate - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc struct"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><p class="location">Struct NaiveDate</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#implementations">Methods</a><div class="sidebar-links"><a href="#method.and_hms">and_hms</a><a href="#method.and_hms_micro">and_hms_micro</a><a href="#method.and_hms_micro_opt">and_hms_micro_opt</a><a href="#method.and_hms_milli">and_hms_milli</a><a href="#method.and_hms_milli_opt">and_hms_milli_opt</a><a href="#method.and_hms_nano">and_hms_nano</a><a href="#method.and_hms_nano_opt">and_hms_nano_opt</a><a href="#method.and_hms_opt">and_hms_opt</a><a href="#method.and_time">and_time</a><a href="#method.checked_add_signed">checked_add_signed</a><a href="#method.checked_sub_signed">checked_sub_signed</a><a href="#method.format">format</a><a href="#method.format_with_items">format_with_items</a><a href="#method.from_isoywd">from_isoywd</a><a href="#method.from_isoywd_opt">from_isoywd_opt</a><a href="#method.from_num_days_from_ce">from_num_days_from_ce</a><a href="#method.from_num_days_from_ce_opt">from_num_days_from_ce_opt</a><a href="#method.from_weekday_of_month">from_weekday_of_month</a><a href="#method.from_weekday_of_month_opt">from_weekday_of_month_opt</a><a href="#method.from_ymd">from_ymd</a><a href="#method.from_ymd_opt">from_ymd_opt</a><a href="#method.from_yo">from_yo</a><a href="#method.from_yo_opt">from_yo_opt</a><a href="#method.iter_days">iter_days</a><a href="#method.iter_weeks">iter_weeks</a><a href="#method.parse_from_str">parse_from_str</a><a href="#method.pred">pred</a><a href="#method.pred_opt">pred_opt</a><a href="#method.signed_duration_since">signed_duration_since</a><a href="#method.succ">succ</a><a href="#method.succ_opt">succ_opt</a></div><a class="sidebar-title" href="#trait-implementations">Trait Implementations</a><div class="sidebar-links"><a href="#impl-Add%3CDuration%3E">Add<Duration></a><a href="#impl-AddAssign%3CDuration%3E">AddAssign<Duration></a><a href="#impl-Clone">Clone</a><a href="#impl-Copy">Copy</a><a href="#impl-Datelike">Datelike</a><a href="#impl-Debug">Debug</a><a href="#impl-Display">Display</a><a href="#impl-Eq">Eq</a><a href="#impl-FromStr">FromStr</a><a href="#impl-Hash">Hash</a><a href="#impl-Ord">Ord</a><a href="#impl-PartialEq%3CNaiveDate%3E">PartialEq<NaiveDate></a><a href="#impl-PartialOrd%3CNaiveDate%3E">PartialOrd<NaiveDate></a><a href="#impl-StructuralEq">StructuralEq</a><a href="#impl-StructuralPartialEq">StructuralPartialEq</a><a href="#impl-Sub%3CDuration%3E">Sub<Duration></a><a href="#impl-Sub%3CNaiveDate%3E">Sub<NaiveDate></a><a href="#impl-SubAssign%3CDuration%3E">SubAssign<Duration></a></div><a class="sidebar-title" href="#synthetic-implementations">Auto Trait Implementations</a><div class="sidebar-links"><a href="#impl-RefUnwindSafe">RefUnwindSafe</a><a href="#impl-Send">Send</a><a href="#impl-Sync">Sync</a><a href="#impl-Unpin">Unpin</a><a href="#impl-UnwindSafe">UnwindSafe</a></div><a class="sidebar-title" href="#blanket-implementations">Blanket Implementations</a><div class="sidebar-links"><a href="#impl-Any">Any</a><a href="#impl-Borrow%3CT%3E">Borrow<T></a><a href="#impl-BorrowMut%3CT%3E">BorrowMut<T></a><a href="#impl-From%3CT%3E">From<T></a><a href="#impl-Into%3CU%3E">Into<U></a><a href="#impl-ToOwned">ToOwned</a><a href="#impl-ToString">ToString</a><a href="#impl-TryFrom%3CU%3E">TryFrom<U></a><a href="#impl-TryInto%3CU%3E">TryInto<U></a></div></div><p class="location"><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></p><div id="sidebar-vars" data-name="NaiveDate" data-ty="struct" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Struct <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="struct" href="">NaiveDate</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/date.rs.html#99-101" title="goto source code">[src]</a></span></h1><div class="docblock type-decl hidden-by-usual-hider"><pre class="rust struct">pub struct NaiveDate { /* fields omitted */ }</pre></div><div class="docblock"><p>ISO 8601 calendar date without timezone.
|
||||
Allows for every <a href="#calendar-date">proleptic Gregorian date</a>
|
||||
from Jan 1, 262145 BCE to Dec 31, 262143 CE.
|
||||
Also supports the conversion from ISO 8601 ordinal and week date.</p>
|
||||
<h1 id="calendar-date" class="section-header"><a href="#calendar-date">Calendar Date</a></h1>
|
||||
<p>The ISO 8601 <strong>calendar date</strong> follows the proleptic Gregorian calendar.
|
||||
It is like a normal civil calendar but note some slight differences:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Dates before the Gregorian calendar’s inception in 1582 are defined via the extrapolation.
|
||||
Be careful, as historical dates are often noted in the Julian calendar and others
|
||||
and the transition to Gregorian may differ across countries (as late as early 20C).</p>
|
||||
<p>(Some example: Both Shakespeare from Britain and Cervantes from Spain seemingly died
|
||||
on the same calendar date—April 23, 1616—but in the different calendar.
|
||||
Britain used the Julian calendar at that time, so Shakespeare’s death is later.)</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>ISO 8601 calendars has the year 0, which is 1 BCE (a year before 1 CE).
|
||||
If you need a typical BCE/BC and CE/AD notation for year numbers,
|
||||
use the <a href="../trait.Datelike.html#method.year_ce"><code>Datelike::year_ce</code></a> method.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<h1 id="week-date" class="section-header"><a href="#week-date">Week Date</a></h1>
|
||||
<p>The ISO 8601 <strong>week date</strong> is a triple of year number, week number
|
||||
and <a href="../enum.Weekday.html">day of the week</a> with the following rules:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>A week consists of Monday through Sunday, and is always numbered within some year.
|
||||
The week number ranges from 1 to 52 or 53 depending on the year.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>The week 1 of given year is defined as the first week containing January 4 of that year,
|
||||
or equivalently, the first week containing four or more days in that year.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>The year number in the week date may <em>not</em> correspond to the actual Gregorian year.
|
||||
For example, January 3, 2016 (Sunday) was on the last (53rd) week of 2015.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>Chrono’s date types default to the ISO 8601 <a href="#calendar-date">calendar date</a>,
|
||||
but <a href="../trait.Datelike.html#tymethod.iso_week"><code>Datelike::iso_week</code></a> and
|
||||
<a href="../trait.Datelike.html#tymethod.weekday"><code>Datelike::weekday</code></a> methods
|
||||
can be used to get the corresponding week date.</p>
|
||||
<h1 id="ordinal-date" class="section-header"><a href="#ordinal-date">Ordinal Date</a></h1>
|
||||
<p>The ISO 8601 <strong>ordinal date</strong> is a pair of year number and day of the year (“ordinal”).
|
||||
The ordinal number ranges from 1 to 365 or 366 depending on the year.
|
||||
The year number is the same as that of the <a href="#calendar-date">calendar date</a>.</p>
|
||||
<p>This is currently the internal format of Chrono’s date types.</p>
|
||||
</div><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><h3 id="impl" class="impl"><code class="in-band">impl <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#136-1100" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.from_ymd" class="method"><code>pub fn <a href="#method.from_ymd" class="fnname">from_ymd</a>(year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, month: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, day: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#172-174" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#calendar-date">calendar date</a>
|
||||
(year, month and day).</p>
|
||||
<p>Panics on the out-of-range date, invalid month and/or day.</p>
|
||||
<h1 id="example" class="section-header"><a href="#example">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">14</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">month</span>(), <span class="number">3</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">day</span>(), <span class="number">14</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">ordinal</span>(), <span class="number">73</span>); <span class="comment">// day of year</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">11</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Sat</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">num_days_from_ce</span>(), <span class="number">735671</span>); <span class="comment">// days since January 1, 1 CE</span></pre></div>
|
||||
</div><h4 id="method.from_ymd_opt" class="method"><code>pub fn <a href="#method.from_ymd_opt" class="fnname">from_ymd_opt</a>(year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, month: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, day: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#195-198" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#calendar-date">calendar date</a>
|
||||
(year, month and day).</p>
|
||||
<p>Returns <code>None</code> on the out-of-range date, invalid month and/or day.</p>
|
||||
<h1 id="example-1" class="section-header"><a href="#example-1">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd_opt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd_opt</span>;
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_ymd_opt</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_ymd_opt</span>(<span class="number">2015</span>, <span class="number">0</span>, <span class="number">14</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_ymd_opt</span>(<span class="number">2015</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_ymd_opt</span>(<span class="op">-</span><span class="number">4</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">is_some</span>()); <span class="comment">// 5 BCE is a leap year</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_ymd_opt</span>(<span class="number">400000</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_ymd_opt</span>(<span class="op">-</span><span class="number">400000</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.from_yo" class="method"><code>pub fn <a href="#method.from_yo" class="fnname">from_yo</a>(year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, ordinal: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#220-222" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#ordinal-date">ordinal date</a>
|
||||
(year and day of the year).</p>
|
||||
<p>Panics on the out-of-range date and/or invalid day of year.</p>
|
||||
<h1 id="example-2" class="section-header"><a href="#example-2">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_yo</span>(<span class="number">2015</span>, <span class="number">73</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">ordinal</span>(), <span class="number">73</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">month</span>(), <span class="number">3</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">day</span>(), <span class="number">14</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">11</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Sat</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">num_days_from_ce</span>(), <span class="number">735671</span>); <span class="comment">// days since January 1, 1 CE</span></pre></div>
|
||||
</div><h4 id="method.from_yo_opt" class="method"><code>pub fn <a href="#method.from_yo_opt" class="fnname">from_yo_opt</a>(year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, ordinal: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#244-247" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#ordinal-date">ordinal date</a>
|
||||
(year and day of the year).</p>
|
||||
<p>Returns <code>None</code> on the out-of-range date and/or invalid day of year.</p>
|
||||
<h1 id="example-3" class="section-header"><a href="#example-3">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_yo_opt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_yo_opt</span>;
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_yo_opt</span>(<span class="number">2015</span>, <span class="number">100</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_yo_opt</span>(<span class="number">2015</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_yo_opt</span>(<span class="number">2015</span>, <span class="number">365</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_yo_opt</span>(<span class="number">2015</span>, <span class="number">366</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_yo_opt</span>(<span class="op">-</span><span class="number">4</span>, <span class="number">366</span>).<span class="ident">is_some</span>()); <span class="comment">// 5 BCE is a leap year</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_yo_opt</span>(<span class="number">400000</span>, <span class="number">1</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_yo_opt</span>(<span class="op">-</span><span class="number">400000</span>, <span class="number">1</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.from_isoywd" class="method"><code>pub fn <a href="#method.from_isoywd" class="fnname">from_isoywd</a>(year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, week: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, weekday: <a class="enum" href="../../chrono/enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#270-272" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#week-date">ISO week date</a>
|
||||
(year, week number and day of the week).
|
||||
The resulting <code>NaiveDate</code> may have a different year from the input year.</p>
|
||||
<p>Panics on the out-of-range date and/or invalid week number.</p>
|
||||
<h1 id="example-4" class="section-header"><a href="#example-4">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_isoywd</span>(<span class="number">2015</span>, <span class="number">11</span>, <span class="ident">Weekday</span>::<span class="ident">Sat</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">11</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Sat</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">month</span>(), <span class="number">3</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">day</span>(), <span class="number">14</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">ordinal</span>(), <span class="number">73</span>); <span class="comment">// day of year</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">num_days_from_ce</span>(), <span class="number">735671</span>); <span class="comment">// days since January 1, 1 CE</span></pre></div>
|
||||
</div><h4 id="method.from_isoywd_opt" class="method"><code>pub fn <a href="#method.from_isoywd_opt" class="fnname">from_isoywd_opt</a>(<br> year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, <br> week: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> weekday: <a class="enum" href="../../chrono/enum.Weekday.html" title="enum chrono::Weekday">Weekday</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#318-347" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> from the <a href="#week-date">ISO week date</a>
|
||||
(year, week number and day of the week).
|
||||
The resulting <code>NaiveDate</code> may have a different year from the input year.</p>
|
||||
<p>Returns <code>None</code> on the out-of-range date and/or invalid week number.</p>
|
||||
<h1 id="example-5" class="section-header"><a href="#example-5">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
<span class="kw">let</span> <span class="ident">from_isoywd_opt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_isoywd_opt</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">0</span>, <span class="ident">Weekday</span>::<span class="ident">Sun</span>), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="ident">Weekday</span>::<span class="ident">Sun</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">8</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">30</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">20</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">60</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>), <span class="prelude-val">None</span>);
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">400000</span>, <span class="number">10</span>, <span class="ident">Weekday</span>::<span class="ident">Fri</span>), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="op">-</span><span class="number">400000</span>, <span class="number">10</span>, <span class="ident">Weekday</span>::<span class="ident">Sat</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
<p>The year number of ISO week date may differ from that of the calendar date.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="comment">// Mo Tu We Th Fr Sa Su</span>
|
||||
<span class="comment">// 2014-W52 22 23 24 25 26 27 28 has 4+ days of new year,</span>
|
||||
<span class="comment">// 2015-W01 29 30 31 1 2 3 4 <- so this is the first week</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2014</span>, <span class="number">52</span>, <span class="ident">Weekday</span>::<span class="ident">Sun</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">28</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2014</span>, <span class="number">53</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">29</span>)));
|
||||
|
||||
<span class="comment">// 2015-W52 21 22 23 24 25 26 27 has 4+ days of old year,</span>
|
||||
<span class="comment">// 2015-W53 28 29 30 31 1 2 3 <- so this is the last week</span>
|
||||
<span class="comment">// 2016-W01 4 5 6 7 8 9 10</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">52</span>, <span class="ident">Weekday</span>::<span class="ident">Sun</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">12</span>, <span class="number">27</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">53</span>, <span class="ident">Weekday</span>::<span class="ident">Sun</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">3</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2015</span>, <span class="number">54</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_isoywd_opt</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="ident">Weekday</span>::<span class="ident">Mon</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">4</span>)));</pre></div>
|
||||
</div><h4 id="method.from_num_days_from_ce" class="method"><code>pub fn <a href="#method.from_num_days_from_ce" class="fnname">from_num_days_from_ce</a>(days: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#393-395" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> from a day’s number in the proleptic Gregorian calendar, with
|
||||
January 1, 1 being day 1.</p>
|
||||
<p>Panics if the date is out of range.</p>
|
||||
<h1 id="example-6" class="section-header"><a href="#example-6">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_num_days_from_ce</span>(<span class="number">735671</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">num_days_from_ce</span>(), <span class="number">735671</span>); <span class="comment">// days since January 1, 1 CE</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">month</span>(), <span class="number">3</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">day</span>(), <span class="number">14</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">ordinal</span>(), <span class="number">73</span>); <span class="comment">// day of year</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">iso_week</span>().<span class="ident">week</span>(), <span class="number">11</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Sat</span>);</pre></div>
|
||||
<p>While not directly supported by Chrono,
|
||||
it is easy to convert from the Julian day number
|
||||
(January 1, 4713 BCE in the <em>Julian</em> calendar being Day 0)
|
||||
to Gregorian with this method.
|
||||
(Note that this panics when <code>jd</code> is out of range.)</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">fn</span> <span class="ident">jd_to_date</span>(<span class="ident">jd</span>: <span class="ident">i32</span>) <span class="op">-</span><span class="op">></span> <span class="ident">NaiveDate</span> {
|
||||
<span class="comment">// keep in mind that the Julian day number is 0-based</span>
|
||||
<span class="comment">// while this method requires an 1-based number.</span>
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_num_days_from_ce</span>(<span class="ident">jd</span> <span class="op">-</span> <span class="number">1721425</span>)
|
||||
}
|
||||
|
||||
<span class="comment">// January 1, 4713 BCE in Julian = November 24, 4714 BCE in Gregorian</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">jd_to_date</span>(<span class="number">0</span>), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">4713</span>, <span class="number">11</span>, <span class="number">24</span>));
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">jd_to_date</span>(<span class="number">1721426</span>), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">jd_to_date</span>(<span class="number">2450000</span>), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1995</span>, <span class="number">10</span>, <span class="number">9</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">jd_to_date</span>(<span class="number">2451545</span>), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2000</span>, <span class="number">1</span>, <span class="number">1</span>));</pre></div>
|
||||
</div><h4 id="method.from_num_days_from_ce_opt" class="method"><code>pub fn <a href="#method.from_num_days_from_ce_opt" class="fnname">from_num_days_from_ce_opt</a>(days: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#417-423" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> from a day’s number in the proleptic Gregorian calendar, with
|
||||
January 1, 1 being day 1.</p>
|
||||
<p>Returns <code>None</code> if the date is out of range.</p>
|
||||
<h1 id="example-7" class="section-header"><a href="#example-7">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ndays_opt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_num_days_from_ce_opt</span>;
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ndays_opt</span>(<span class="number">730_000</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">1999</span>, <span class="number">9</span>, <span class="number">3</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ndays_opt</span>(<span class="number">1</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ndays_opt</span>(<span class="number">0</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">0</span>, <span class="number">12</span>, <span class="number">31</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ndays_opt</span>(<span class="op">-</span><span class="number">1</span>), <span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">0</span>, <span class="number">12</span>, <span class="number">30</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ndays_opt</span>(<span class="number">100_000_000</span>), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ndays_opt</span>(<span class="op">-</span><span class="number">100_000_000</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.from_weekday_of_month" class="method"><code>pub fn <a href="#method.from_weekday_of_month" class="fnname">from_weekday_of_month</a>(<br> year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, <br> month: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> weekday: <a class="enum" href="../../chrono/enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>, <br> n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u8.html">u8</a><br>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#450-452" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> by counting the number of occurrences of a particular day-of-week
|
||||
since the beginning of the given month. For instance, if you want the 2nd Friday of March
|
||||
2017, you would use <code>NaiveDate::from_weekday_of_month(2017, 3, Weekday::Fri, 2)</code>.</p>
|
||||
<h1 id="panics" class="section-header"><a href="#panics">Panics</a></h1>
|
||||
<p>The resulting <code>NaiveDate</code> is guaranteed to be in <code>month</code>. If <code>n</code> is larger than the number
|
||||
of <code>weekday</code> in <code>month</code> (eg. the 6th Friday of March 2017) then this function will panic.</p>
|
||||
<p><code>n</code> is 1-indexed. Passing <code>n=0</code> will cause a panic.</p>
|
||||
<h1 id="example-8" class="section-header"><a href="#example-8">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_weekday_of_month</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_weekday_of_month</span>;
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday</span>::<span class="ident">Wed</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday</span>::<span class="ident">Fri</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">3</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday</span>::<span class="ident">Tue</span>, <span class="number">2</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">14</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday</span>::<span class="ident">Fri</span>, <span class="number">4</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">24</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_weekday_of_month</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="ident">Weekday</span>::<span class="ident">Fri</span>, <span class="number">5</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">8</span>, <span class="number">31</span>));</pre></div>
|
||||
</div><h4 id="method.from_weekday_of_month_opt" class="method"><code>pub fn <a href="#method.from_weekday_of_month_opt" class="fnname">from_weekday_of_month_opt</a>(<br> year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, <br> month: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> weekday: <a class="enum" href="../../chrono/enum.Weekday.html" title="enum chrono::Weekday">Weekday</a>, <br> n: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u8.html">u8</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#466-479" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> by counting the number of occurrences of a particular day-of-week
|
||||
since the beginning of the given month. For instance, if you want the 2nd Friday of March
|
||||
2017, you would use <code>NaiveDate::from_weekday_of_month(2017, 3, Weekday::Fri, 2)</code>. <code>n</code> is 1-indexed.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Weekday</span>};
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_weekday_of_month_opt</span>(<span class="number">2017</span>, <span class="number">3</span>, <span class="ident">Weekday</span>::<span class="ident">Fri</span>, <span class="number">2</span>),
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd_opt</span>(<span class="number">2017</span>, <span class="number">3</span>, <span class="number">10</span>))</pre></div>
|
||||
<p>Returns <code>None</code> if <code>n</code> out-of-range; ie. if <code>n</code> is larger than the number of <code>weekday</code> in
|
||||
<code>month</code> (eg. the 6th Friday of March 2017), or if <code>n == 0</code>.</p>
|
||||
</div><h4 id="method.parse_from_str" class="method"><code>pub fn <a href="#method.parse_from_str" class="fnname">parse_from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>, fmt: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="type" href="../../chrono/format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#523-527" title="goto source code">[src]</a></h4><div class="docblock"><p>Parses a string with the specified format string and returns a new <code>NaiveDate</code>.
|
||||
See the <a href="../format/strftime/index.html"><code>format::strftime</code> module</a>
|
||||
on the supported escape sequences.</p>
|
||||
<h1 id="example-9" class="section-header"><a href="#example-9">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">parse_from_str</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">parse_from_str</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2015-09-05"</span>, <span class="string">"%Y-%m-%d"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"5sep2015"</span>, <span class="string">"%d%b%Y"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>)));</pre></div>
|
||||
<p>Time and offset is ignored for the purpose of parsing.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2014-5-17T12:34:56+09:30"</span>, <span class="string">"%Y-%m-%dT%H:%M:%S%z"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">5</span>, <span class="number">17</span>)));</pre></div>
|
||||
<p>Out-of-bound dates or insufficient fields are errors.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2015/9"</span>, <span class="string">"%Y/%m"</span>).<span class="ident">is_err</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2015/9/31"</span>, <span class="string">"%Y/%m/%d"</span>).<span class="ident">is_err</span>());</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">
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"Sat, 09 Aug 2013"</span>, <span class="string">"%a, %d %b %Y"</span>).<span class="ident">is_err</span>());</pre></div>
|
||||
</div><h4 id="method.and_time" class="method"><code>pub fn <a href="#method.and_time" class="fnname">and_time</a>(&self, time: <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#544-546" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date and given <code>NaiveTime</code>.</p>
|
||||
<h1 id="example-10" class="section-header"><a href="#example-10">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveTime</span>, <span class="ident">NaiveDateTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_time</span>(<span class="ident">t</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">date</span>(), <span class="ident">d</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">time</span>(), <span class="ident">t</span>);</pre></div>
|
||||
</div><h4 id="method.and_hms" class="method"><code>pub fn <a href="#method.and_hms" class="fnname">and_hms</a>(&self, hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#568-570" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute and second.</p>
|
||||
<p>No <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a> is allowed here;
|
||||
use <code>NaiveDate::and_hms_*</code> methods with a subsecond parameter instead.</p>
|
||||
<p>Panics on invalid hour, minute and/or second.</p>
|
||||
<h1 id="example-11" class="section-header"><a href="#example-11">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Wed</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);</pre></div>
|
||||
</div><h4 id="method.and_hms_opt" class="method"><code>pub fn <a href="#method.and_hms_opt" class="fnname">and_hms_opt</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#591-593" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute and second.</p>
|
||||
<p>No <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a> is allowed here;
|
||||
use <code>NaiveDate::and_hms_*_opt</code> methods with a subsecond parameter instead.</p>
|
||||
<p>Returns <code>None</code> on invalid hour, minute and/or second.</p>
|
||||
<h1 id="example-12" class="section-header"><a href="#example-12">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>).<span class="ident">is_none</span>()); <span class="comment">// use `and_hms_milli_opt` instead</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_opt</span>(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_opt</span>(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.and_hms_milli" class="method"><code>pub fn <a href="#method.and_hms_milli" class="fnname">and_hms_milli</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> milli: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#616-618" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and millisecond.</p>
|
||||
<p>The millisecond part can exceed 1,000
|
||||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||||
<p>Panics on invalid hour, minute, second and/or millisecond.</p>
|
||||
<h1 id="example-13" class="section-header"><a href="#example-13">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Wed</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">nanosecond</span>(), <span class="number">789_000_000</span>);</pre></div>
|
||||
</div><h4 id="method.and_hms_milli_opt" class="method"><code>pub fn <a href="#method.and_hms_milli_opt" class="fnname">and_hms_milli_opt</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> milli: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#641-649" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and millisecond.</p>
|
||||
<p>The millisecond part can exceed 1,000
|
||||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||||
<p>Returns <code>None</code> on invalid hour, minute, second and/or millisecond.</p>
|
||||
<h1 id="example-14" class="section-header"><a href="#example-14">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789</span>).<span class="ident">is_some</span>()); <span class="comment">// leap second</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli_opt</span>(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.and_hms_micro" class="method"><code>pub fn <a href="#method.and_hms_micro" class="fnname">and_hms_micro</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> micro: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#672-674" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and microsecond.</p>
|
||||
<p>The microsecond part can exceed 1,000,000
|
||||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||||
<p>Panics on invalid hour, minute, second and/or microsecond.</p>
|
||||
<h1 id="example-15" class="section-header"><a href="#example-15">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_hms_micro</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Wed</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">nanosecond</span>(), <span class="number">789_012_000</span>);</pre></div>
|
||||
</div><h4 id="method.and_hms_micro_opt" class="method"><code>pub fn <a href="#method.and_hms_micro_opt" class="fnname">and_hms_micro_opt</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> micro: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#697-705" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and microsecond.</p>
|
||||
<p>The microsecond part can exceed 1,000,000
|
||||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||||
<p>Returns <code>None</code> on invalid hour, minute, second and/or microsecond.</p>
|
||||
<h1 id="example-16" class="section-header"><a href="#example-16">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789_012</span>).<span class="ident">is_some</span>()); <span class="comment">// leap second</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789_012</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789_012</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789_012</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_micro_opt</span>(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.and_hms_nano" class="method"><code>pub fn <a href="#method.and_hms_nano" class="fnname">and_hms_nano</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> nano: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#728-730" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and nanosecond.</p>
|
||||
<p>The nanosecond part can exceed 1,000,000,000
|
||||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||||
<p>Panics on invalid hour, minute, second and/or nanosecond.</p>
|
||||
<h1 id="example-17" class="section-header"><a href="#example-17">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">d</span>.<span class="ident">and_hms_nano</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012_345</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Wed</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">nanosecond</span>(), <span class="number">789_012_345</span>);</pre></div>
|
||||
</div><h4 id="method.and_hms_nano_opt" class="method"><code>pub fn <a href="#method.and_hms_nano_opt" class="fnname">and_hms_nano_opt</a>(<br> &self, <br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> nano: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#753-761" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> from the current date, hour, minute, second and nanosecond.</p>
|
||||
<p>The nanosecond part can exceed 1,000,000,000
|
||||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||||
<p>Returns <code>None</code> on invalid hour, minute, second and/or nanosecond.</p>
|
||||
<h1 id="example-18" class="section-header"><a href="#example-18">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">1_789_012_345</span>).<span class="ident">is_some</span>()); <span class="comment">// leap second</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">59</span>, <span class="number">2_789_012_345</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">60</span>, <span class="number">789_012_345</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">12</span>, <span class="number">60</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_nano_opt</span>(<span class="number">24</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789_012_345</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.succ" class="method"><code>pub fn <a href="#method.succ" class="fnname">succ</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#810-812" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the next calendar date.</p>
|
||||
<p>Panics when <code>self</code> is the last representable date.</p>
|
||||
<h1 id="example-19" class="section-header"><a href="#example-19">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).<span class="ident">succ</span>(), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">4</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">succ</span>(), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">succ</span>(), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>));</pre></div>
|
||||
</div><h4 id="method.succ_opt" class="method"><code>pub fn <a href="#method.succ_opt" class="fnname">succ_opt</a>(&self) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#829-831" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the next calendar date.</p>
|
||||
<p>Returns <code>None</code> when <code>self</code> is the last representable date.</p>
|
||||
<h1 id="example-20" class="section-header"><a href="#example-20">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">naive</span>::<span class="ident">MAX_DATE</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).<span class="ident">succ_opt</span>(),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">4</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">MAX_DATE</span>.<span class="ident">succ_opt</span>(), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.pred" class="method"><code>pub fn <a href="#method.pred" class="fnname">pred</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#847-849" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the previous calendar date.</p>
|
||||
<p>Panics when <code>self</code> is the first representable date.</p>
|
||||
<h1 id="example-21" class="section-header"><a href="#example-21">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).<span class="ident">pred</span>(), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">2</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">1</span>).<span class="ident">pred</span>(), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">5</span>, <span class="number">31</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">pred</span>(), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">31</span>));</pre></div>
|
||||
</div><h4 id="method.pred_opt" class="method"><code>pub fn <a href="#method.pred_opt" class="fnname">pred_opt</a>(&self) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#866-868" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> for the previous calendar date.</p>
|
||||
<p>Returns <code>None</code> when <code>self</code> is the first representable date.</p>
|
||||
<h1 id="example-22" class="section-header"><a href="#example-22">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">naive</span>::<span class="ident">MIN_DATE</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>).<span class="ident">pred_opt</span>(),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">2</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">MIN_DATE</span>.<span class="ident">pred_opt</span>(), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.checked_add_signed" class="method"><code>pub fn <a href="#method.checked_add_signed" class="fnname">checked_add_signed</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#891-902" title="goto source code">[src]</a></h4><div class="docblock"><p>Adds the <code>days</code> part of given <code>Duration</code> to the current date.</p>
|
||||
<p>Returns <code>None</code> when it will result in overflow.</p>
|
||||
<h1 id="example-23" class="section-header"><a href="#example-23">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">naive</span>::<span class="ident">MAX_DATE</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">40</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">15</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="op">-</span><span class="number">40</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">27</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="op">-</span><span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">MAX_DATE</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>)), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.checked_sub_signed" class="method"><code>pub fn <a href="#method.checked_sub_signed" class="fnname">checked_sub_signed</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#925-936" title="goto source code">[src]</a></h4><div class="docblock"><p>Subtracts the <code>days</code> part of given <code>Duration</code> from the current date.</p>
|
||||
<p>Returns <code>None</code> when it will result in overflow.</p>
|
||||
<h1 id="example-24" class="section-header"><a href="#example-24">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">naive</span>::<span class="ident">MIN_DATE</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">40</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">27</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="op">-</span><span class="number">40</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">15</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="op">-</span><span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">MIN_DATE</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>)), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.signed_duration_since" class="method"><code>pub fn <a href="#method.signed_duration_since" class="fnname">signed_duration_since</a>(self, rhs: <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#962-972" title="goto source code">[src]</a></h4><div class="docblock"><p>Subtracts another <code>NaiveDate</code> from the current date.
|
||||
Returns a <code>Duration</code> of integral numbers.</p>
|
||||
<p>This does not overflow or underflow at all,
|
||||
as all possible output fits in the range of <code>Duration</code>.</p>
|
||||
<h1 id="example-25" class="section-header"><a href="#example-25">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
<span class="kw">let</span> <span class="ident">since</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">signed_duration_since</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="ident">Duration</span>::<span class="ident">zero</span>());
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>)), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>)), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="op">-</span><span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">9</span>, <span class="number">23</span>)), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">100</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">4</span> <span class="op">+</span> <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">1614</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">400</span> <span class="op">+</span> <span class="number">97</span>));</pre></div>
|
||||
</div><h4 id="method.format_with_items" class="method"><code>pub fn <a href="#method.format_with_items" class="fnname">format_with_items</a><'a, I, B>(&self, items: I) -> <a class="struct" href="../../chrono/format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><I> <span class="where fmt-newline">where<br> I: <a class="trait" href="https://doc.rust-lang.org/nightly/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/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,<br> B: <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><<a class="enum" href="../../chrono/format/enum.Item.html" title="enum chrono::format::Item">Item</a><'a>>, </span></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1003-1009" title="goto source code">[src]</a></h4><div class="docblock"><p>Formats the date with the specified formatting items.
|
||||
Otherwise it is the same as the ordinary <code>format</code> method.</p>
|
||||
<p>The <code>Iterator</code> of items should be <code>Clone</code>able,
|
||||
since the resulting <code>DelayedFormat</code> value may be formatted multiple times.</p>
|
||||
<h1 id="example-26" class="section-header"><a href="#example-26">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">format</span>::<span class="ident">strftime</span>::<span class="ident">StrftimeItems</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">fmt</span> <span class="op">=</span> <span class="ident">StrftimeItems</span>::<span class="ident">new</span>(<span class="string">"%Y-%m-%d"</span>);
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>.<span class="ident">clone</span>()).<span class="ident">to_string</span>(), <span class="string">"2015-09-05"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%Y-%m-%d"</span>).<span class="ident">to_string</span>(), <span class="string">"2015-09-05"</span>);</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">d</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>)), <span class="string">"2015-09-05"</span>);</pre></div>
|
||||
</div><h4 id="method.format" class="method"><code>pub fn <a href="#method.format" class="fnname">format</a><'a>(&self, fmt: &'a <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="struct" href="../../chrono/format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><<a class="struct" href="../../chrono/format/strftime/struct.StrftimeItems.html" title="struct chrono::format::strftime::StrftimeItems">StrftimeItems</a><'a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1045-1047" title="goto source code">[src]</a></h4><div class="docblock"><p>Formats the date with the specified format string.
|
||||
See the <a href="../format/strftime/index.html"><code>format::strftime</code> module</a>
|
||||
on the supported escape sequences.</p>
|
||||
<p>This returns a <code>DelayedFormat</code>,
|
||||
which gets converted to a string only when actual formatting happens.
|
||||
You may use the <code>to_string</code> method to get a <code>String</code>,
|
||||
or just feed it into <code>print!</code> and other formatting macros.
|
||||
(In this way it avoids the redundant memory allocation.)</p>
|
||||
<p>A wrong format string does <em>not</em> issue an error immediately.
|
||||
Rather, converting or formatting the <code>DelayedFormat</code> fails.
|
||||
You are recommended to immediately use <code>DelayedFormat</code> for this reason.</p>
|
||||
<h1 id="example-27" class="section-header"><a href="#example-27">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%Y-%m-%d"</span>).<span class="ident">to_string</span>(), <span class="string">"2015-09-05"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%A, %-d %B, %C%y"</span>).<span class="ident">to_string</span>(), <span class="string">"Saturday, 5 September, 2015"</span>);</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%Y-%m-%d"</span>)), <span class="string">"2015-09-05"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">d</span>.<span class="ident">format</span>(<span class="string">"%A, %-d %B, %C%y"</span>)), <span class="string">"Saturday, 5 September, 2015"</span>);</pre></div>
|
||||
</div><h4 id="method.iter_days" class="method"><code>pub fn <a href="#method.iter_days" class="fnname">iter_days</a>(&self) -> NaiveDateDaysIterator</code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1071-1073" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns an iterator that steps by days until the last representable date.</p>
|
||||
<h1 id="example-28" class="section-header"><a href="#example-28">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
|
||||
<span class="kw">let</span> <span class="ident">expected</span> <span class="op">=</span> [
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>),
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">28</span>),
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>),
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">1</span>),
|
||||
];
|
||||
|
||||
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">count</span> <span class="op">=</span> <span class="number">0</span>;
|
||||
<span class="kw">for</span> (<span class="ident">idx</span>, <span class="ident">d</span>) <span class="kw">in</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>).<span class="ident">iter_days</span>().<span class="ident">take</span>(<span class="number">4</span>).<span class="ident">enumerate</span>() {
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>, <span class="ident">expected</span>[<span class="ident">idx</span>]);
|
||||
<span class="ident">count</span> <span class="op">+</span><span class="op">=</span> <span class="number">1</span>;
|
||||
}
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">count</span>, <span class="number">4</span>);</pre></div>
|
||||
</div><h4 id="method.iter_weeks" class="method"><code>pub fn <a href="#method.iter_weeks" class="fnname">iter_weeks</a>(&self) -> NaiveDateWeeksIterator</code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1097-1099" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns an iterator that steps by weeks until the last representable date.</p>
|
||||
<h1 id="example-29" class="section-header"><a href="#example-29">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
|
||||
<span class="kw">let</span> <span class="ident">expected</span> <span class="op">=</span> [
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>),
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">5</span>),
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">12</span>),
|
||||
<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">3</span>, <span class="number">19</span>),
|
||||
];
|
||||
|
||||
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">count</span> <span class="op">=</span> <span class="number">0</span>;
|
||||
<span class="kw">for</span> (<span class="ident">idx</span>, <span class="ident">d</span>) <span class="kw">in</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">27</span>).<span class="ident">iter_weeks</span>().<span class="ident">take</span>(<span class="number">4</span>).<span class="ident">enumerate</span>() {
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>, <span class="ident">expected</span>[<span class="ident">idx</span>]);
|
||||
<span class="ident">count</span> <span class="op">+</span><span class="op">=</span> <span class="number">1</span>;
|
||||
}
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">count</span>, <span class="number">4</span>);</pre></div>
|
||||
</div></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><h3 id="impl-Add%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Add%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1468-1475" title="goto source code">[src]</a></h3><div class="docblock"><p>An addition of <code>Duration</code> to <code>NaiveDate</code> discards the fractional days,
|
||||
rounding to the closest integral number of days towards <code>Duration::zero()</code>.</p>
|
||||
<p>Panics on underflow or overflow.
|
||||
Use <a href="#method.checked_add_signed"><code>NaiveDate::checked_add_signed</code></a> to detect that.</p>
|
||||
<h1 id="example-49" class="section-header"><a href="#example-49">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">86399</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">86399</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">364</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">12</span>, <span class="number">31</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">4</span> <span class="op">+</span> <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2018</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">400</span> <span class="op">+</span> <span class="number">97</span>), <span class="ident">from_ymd</span>(<span class="number">2414</span>, <span class="number">1</span>, <span class="number">1</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output-2" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>+</code> operator.</p>
|
||||
</div><h4 id="method.add" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add" class="fnname">add</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1472-1474" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></p>
|
||||
</div></div><h3 id="impl-AddAssign%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html" title="trait core::ops::arith::AddAssign">AddAssign</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-AddAssign%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1477-1482" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.add_assign" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html#tymethod.add_assign" class="fnname">add_assign</a>(&mut self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1479-1481" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>+=</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html#tymethod.add_assign">Read more</a></p>
|
||||
</div></div><h3 id="impl-Clone" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Clone" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.clone" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone" class="fnname">clone</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns a copy of the value. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone">Read more</a></p>
|
||||
</div><h4 id="method.clone_from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from" class="fnname">clone_from</a>(&mut self, source: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Self)</code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/clone.rs.html#128" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from">Read more</a></p>
|
||||
</div></div><h3 id="impl-Copy" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Copy.html" title="trait core::marker::Copy">Copy</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Copy" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-Datelike" class="impl"><code class="in-band">impl <a class="trait" href="../../chrono/trait.Datelike.html" title="trait chrono::Datelike">Datelike</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Datelike" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1102-1442" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.year" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.year" class="fnname">year</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1114-1116" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the year number in the <a href="#calendar-date">calendar date</a>.</p>
|
||||
<h1 id="example-30" class="section-header"><a href="#example-30">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">year</span>(), <span class="number">2015</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">year</span>(), <span class="op">-</span><span class="number">308</span>); <span class="comment">// 309 BCE</span></pre></div>
|
||||
</div><h4 id="method.month" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.month" class="fnname">month</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1131-1133" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the month number starting from 1.</p>
|
||||
<p>The return value ranges from 1 to 12.</p>
|
||||
<h1 id="example-31" class="section-header"><a href="#example-31">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">month</span>(), <span class="number">9</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">month</span>(), <span class="number">3</span>);</pre></div>
|
||||
</div><h4 id="method.month0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.month0" class="fnname">month0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1148-1150" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the month number starting from 0.</p>
|
||||
<p>The return value ranges from 0 to 11.</p>
|
||||
<h1 id="example-32" class="section-header"><a href="#example-32">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">month0</span>(), <span class="number">8</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">month0</span>(), <span class="number">2</span>);</pre></div>
|
||||
</div><h4 id="method.day" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.day" class="fnname">day</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1188-1190" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-33" class="section-header"><a href="#example-33">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">day</span>(), <span class="number">8</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">day</span>(), <span class="number">14</span>);</pre></div>
|
||||
<p>Combined with <a href="#method.pred"><code>NaiveDate::pred</code></a>,
|
||||
one can determine the number of days in a particular month.
|
||||
(Note that this panics when <code>year</code> is out of range.)</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">fn</span> <span class="ident">ndays_in_month</span>(<span class="ident">year</span>: <span class="ident">i32</span>, <span class="ident">month</span>: <span class="ident">u32</span>) <span class="op">-</span><span class="op">></span> <span class="ident">u32</span> {
|
||||
<span class="comment">// the first day of the next month...</span>
|
||||
<span class="kw">let</span> (<span class="ident">y</span>, <span class="ident">m</span>) <span class="op">=</span> <span class="kw">if</span> <span class="ident">month</span> <span class="op">=</span><span class="op">=</span> <span class="number">12</span> { (<span class="ident">year</span> <span class="op">+</span> <span class="number">1</span>, <span class="number">1</span>) } <span class="kw">else</span> { (<span class="ident">year</span>, <span class="ident">month</span> <span class="op">+</span> <span class="number">1</span>) };
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="ident">y</span>, <span class="ident">m</span>, <span class="number">1</span>);
|
||||
|
||||
<span class="comment">// ...is preceded by the last day of the original month</span>
|
||||
<span class="ident">d</span>.<span class="ident">pred</span>().<span class="ident">day</span>()
|
||||
}
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2015</span>, <span class="number">8</span>), <span class="number">31</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2015</span>, <span class="number">9</span>), <span class="number">30</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2015</span>, <span class="number">12</span>), <span class="number">31</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2016</span>, <span class="number">2</span>), <span class="number">29</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_month</span>(<span class="number">2017</span>, <span class="number">2</span>), <span class="number">28</span>);</pre></div>
|
||||
</div><h4 id="method.day0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.day0" class="fnname">day0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1205-1207" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-34" class="section-header"><a href="#example-34">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">day0</span>(), <span class="number">7</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">day0</span>(), <span class="number">13</span>);</pre></div>
|
||||
</div><h4 id="method.ordinal" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.ordinal" class="fnname">ordinal</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1244-1246" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-35" class="section-header"><a href="#example-35">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">ordinal</span>(), <span class="number">251</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">ordinal</span>(), <span class="number">74</span>);</pre></div>
|
||||
<p>Combined with <a href="#method.pred"><code>NaiveDate::pred</code></a>,
|
||||
one can determine the number of days in a particular year.
|
||||
(Note that this panics when <code>year</code> is out of range.)</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">fn</span> <span class="ident">ndays_in_year</span>(<span class="ident">year</span>: <span class="ident">i32</span>) <span class="op">-</span><span class="op">></span> <span class="ident">u32</span> {
|
||||
<span class="comment">// the first day of the next year...</span>
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="ident">year</span> <span class="op">+</span> <span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>);
|
||||
|
||||
<span class="comment">// ...is preceded by the last day of the original year</span>
|
||||
<span class="ident">d</span>.<span class="ident">pred</span>().<span class="ident">ordinal</span>()
|
||||
}
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2015</span>), <span class="number">365</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2016</span>), <span class="number">366</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2017</span>), <span class="number">365</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2000</span>), <span class="number">366</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ndays_in_year</span>(<span class="number">2100</span>), <span class="number">365</span>);</pre></div>
|
||||
</div><h4 id="method.ordinal0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.ordinal0" class="fnname">ordinal0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1261-1263" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-36" class="section-header"><a href="#example-36">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">ordinal0</span>(), <span class="number">250</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">ordinal0</span>(), <span class="number">73</span>);</pre></div>
|
||||
</div><h4 id="method.weekday" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.weekday" class="fnname">weekday</a>(&self) -> <a class="enum" href="../../chrono/enum.Weekday.html" title="enum chrono::Weekday">Weekday</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1276-1278" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the day of week.</p>
|
||||
<h1 id="example-37" class="section-header"><a href="#example-37">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Tue</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">3</span>, <span class="number">14</span>).<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Fri</span>);</pre></div>
|
||||
</div><h4 id="method.iso_week" class="method hidden"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.iso_week" class="fnname">iso_week</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1281-1283" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns the ISO week.</p>
|
||||
</div><h4 id="method.with_year" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_year" class="fnname">with_year</a>(&self, year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1308-1317" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the year number changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||||
<h1 id="example-38" class="section-header"><a href="#example-38">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_year</span>(<span class="number">2016</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">8</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_year</span>(<span class="op">-</span><span class="number">308</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">9</span>, <span class="number">8</span>)));</pre></div>
|
||||
<p>A leap day (February 29) is a good example that this method can return <code>None</code>.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">with_year</span>(<span class="number">2015</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">with_year</span>(<span class="number">2020</span>).<span class="ident">is_some</span>());</pre></div>
|
||||
</div><h4 id="method.with_month" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_month" class="fnname">with_month</a>(&self, month: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1334-1336" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the month number (starting from 1) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||||
<h1 id="example-39" class="section-header"><a href="#example-39">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_month</span>(<span class="number">10</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">8</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_month</span>(<span class="number">13</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).<span class="ident">with_month</span>(<span class="number">2</span>), <span class="prelude-val">None</span>); <span class="comment">// no February 30</span></pre></div>
|
||||
</div><h4 id="method.with_month0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_month0" class="fnname">with_month0</a>(&self, month0: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1353-1355" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the month number (starting from 0) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||||
<h1 id="example-40" class="section-header"><a href="#example-40">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_month0</span>(<span class="number">9</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">8</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_month0</span>(<span class="number">12</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).<span class="ident">with_month0</span>(<span class="number">1</span>), <span class="prelude-val">None</span>); <span class="comment">// no February 30</span></pre></div>
|
||||
</div><h4 id="method.with_day" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_day" class="fnname">with_day</a>(&self, day: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1372-1374" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of month (starting from 1) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||||
<h1 id="example-41" class="section-header"><a href="#example-41">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_day</span>(<span class="number">30</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_day</span>(<span class="number">31</span>),
|
||||
<span class="prelude-val">None</span>); <span class="comment">// no September 31</span></pre></div>
|
||||
</div><h4 id="method.with_day0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_day0" class="fnname">with_day0</a>(&self, day0: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1391-1393" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of month (starting from 0) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||||
<h1 id="example-42" class="section-header"><a href="#example-42">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_day0</span>(<span class="number">29</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">with_day0</span>(<span class="number">30</span>),
|
||||
<span class="prelude-val">None</span>); <span class="comment">// no September 31</span></pre></div>
|
||||
</div><h4 id="method.with_ordinal" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_ordinal" class="fnname">with_ordinal</a>(&self, ordinal: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1415-1417" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of year (starting from 1) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||||
<h1 id="example-43" class="section-header"><a href="#example-43">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal</span>(<span class="number">60</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal</span>(<span class="number">366</span>),
|
||||
<span class="prelude-val">None</span>); <span class="comment">// 2015 had only 365 days</span>
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal</span>(<span class="number">60</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal</span>(<span class="number">366</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>)));</pre></div>
|
||||
</div><h4 id="method.with_ordinal0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_ordinal0" class="fnname">with_ordinal0</a>(&self, ordinal0: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1439-1441" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDate</code> with the day of year (starting from 0) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDate</code> would be invalid.</p>
|
||||
<h1 id="example-44" class="section-header"><a href="#example-44">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal0</span>(<span class="number">59</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal0</span>(<span class="number">365</span>),
|
||||
<span class="prelude-val">None</span>); <span class="comment">// 2015 had only 365 days</span>
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal0</span>(<span class="number">59</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">with_ordinal0</span>(<span class="number">365</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>)));</pre></div>
|
||||
</div><h4 id="method.year_ce" class="method hidden"><code>fn <a href="../../chrono/trait.Datelike.html#method.year_ce" class="fnname">year_ce</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code><a class="srclink" href="../../src/chrono/lib.rs.html#1252-1259" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns the absolute year number starting from 1 with a boolean flag,
|
||||
which is false when the year predates the epoch (BCE/BC) and true otherwise (CE/AD). <a href="../../chrono/trait.Datelike.html#method.year_ce">Read more</a></p>
|
||||
</div><h4 id="method.num_days_from_ce" class="method hidden"><code>fn <a href="../../chrono/trait.Datelike.html#method.num_days_from_ce" class="fnname">num_days_from_ce</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a></code><a class="srclink" href="../../src/chrono/lib.rs.html#1344-1359" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Counts the days in the proleptic Gregorian calendar, with January 1, Year 1 (CE) as day 1. <a href="../../chrono/trait.Datelike.html#method.num_days_from_ce">Read more</a></p>
|
||||
</div></div><h3 id="impl-Debug" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Debug" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1639-1650" title="goto source code">[src]</a></h3><div class="docblock"><p>The <code>Debug</code> output of the naive date <code>d</code> is the same as
|
||||
<a href="../format/strftime/index.html"><code>d.format("%Y-%m-%d")</code></a>.</p>
|
||||
<p>The string printed can be readily parsed via the <code>parse</code> method on <code>str</code>.</p>
|
||||
<h1 id="example-45" class="section-header"><a href="#example-45">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>)), <span class="string">"2015-09-05"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>( <span class="number">0</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="string">"0000-01-01"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">9999</span>, <span class="number">12</span>, <span class="number">31</span>)), <span class="string">"9999-12-31"</span>);</pre></div>
|
||||
<p>ISO 8601 requires an explicit sign for years before 1 BCE or after 9999 CE.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>( <span class="op">-</span><span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="string">"-0001-01-01"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">10000</span>, <span class="number">12</span>, <span class="number">31</span>)), <span class="string">"+10000-12-31"</span>);</pre></div>
|
||||
</div><div class="impl-items"><h4 id="method.fmt" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/nightly/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1640-1649" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></p>
|
||||
</div></div><h3 id="impl-Display" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Display" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1674-1678" title="goto source code">[src]</a></h3><div class="docblock"><p>The <code>Display</code> output of the naive date <code>d</code> is the same as
|
||||
<a href="../format/strftime/index.html"><code>d.format("%Y-%m-%d")</code></a>.</p>
|
||||
<p>The string printed can be readily parsed via the <code>parse</code> method on <code>str</code>.</p>
|
||||
<h1 id="example-46" class="section-header"><a href="#example-46">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>)), <span class="string">"2015-09-05"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>( <span class="number">0</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="string">"0000-01-01"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">9999</span>, <span class="number">12</span>, <span class="number">31</span>)), <span class="string">"9999-12-31"</span>);</pre></div>
|
||||
<p>ISO 8601 requires an explicit sign for years before 1 BCE or after 9999 CE.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>( <span class="op">-</span><span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>)), <span class="string">"-0001-01-01"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">10000</span>, <span class="number">12</span>, <span class="number">31</span>)), <span class="string">"+10000-12-31"</span>);</pre></div>
|
||||
</div><div class="impl-items"><h4 id="method.fmt-1" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/nightly/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1675-1677" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html#tymethod.fmt">Read more</a></p>
|
||||
</div></div><h3 id="impl-Eq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Eq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-FromStr" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html" title="trait core::str::traits::FromStr">FromStr</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-FromStr" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1696-1715" title="goto source code">[src]</a></h3><div class="docblock"><p>Parsing a <code>str</code> into a <code>NaiveDate</code> uses the same format,
|
||||
<a href="../format/strftime/index.html"><code>%Y-%m-%d</code></a>, as in <code>Debug</code> and <code>Display</code>.</p>
|
||||
<h1 id="example-50" class="section-header"><a href="#example-50">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">18</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="string">"2015-09-18"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDate</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">d</span>));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">12345</span>, <span class="number">6</span>, <span class="number">7</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="string">"+12345-6-7"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDate</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">d</span>));
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="string">"foo"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDate</span><span class="op">></span>().<span class="ident">is_err</span>());</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Err" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#associatedtype.Err" class="type">Err</a> = <a class="struct" href="../../chrono/format/struct.ParseError.html" title="struct chrono::format::ParseError">ParseError</a></code></h4><div class='docblock'><p>The associated error which can be returned from parsing.</p>
|
||||
</div><h4 id="method.from_str" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#tymethod.from_str" class="fnname">from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="type" href="../../chrono/format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1699-1714" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Parses a string <code>s</code> to return a value of this type. <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#tymethod.from_str">Read more</a></p>
|
||||
</div></div><h3 id="impl-Hash" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Hash" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.hash" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#tymethod.hash" class="fnname">hash</a><__H: <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>>(&self, state: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>__H)</code><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Feeds this value into the given <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#tymethod.hash">Read more</a></p>
|
||||
</div><h4 id="method.hash_slice" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#method.hash_slice" class="fnname">hash_slice</a><H>(data: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&[Self]</a>, state: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>H) <span class="where fmt-newline">where<br> H: <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>, </span></code><span class="since" title="Stable since Rust version 1.3.0">1.3.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/hash/mod.rs.html#184-186" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Feeds a slice of this type into the given <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#method.hash_slice">Read more</a></p>
|
||||
</div></div><h3 id="impl-Ord" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html" title="trait core::cmp::Ord">Ord</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Ord" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.cmp" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#tymethod.cmp" class="fnname">cmp</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method returns an <a href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="Ordering"><code>Ordering</code></a> between <code>self</code> and <code>other</code>. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#tymethod.cmp">Read more</a></p>
|
||||
</div><h4 id="method.max" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.max" class="fnname">max</a>(self, other: Self) -> Self</code><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#723-725" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Compares and returns the maximum of two values. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.max">Read more</a></p>
|
||||
</div><h4 id="method.min" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.min" class="fnname">min</a>(self, other: Self) -> Self</code><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#743-745" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Compares and returns the minimum of two values. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.min">Read more</a></p>
|
||||
</div><h4 id="method.clamp" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.clamp" class="fnname">clamp</a>(self, min: Self, max: Self) -> Self</code><span class="since" title="Stable since Rust version 1.50.0">1.50.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#768-770" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Restrict a value to a certain interval. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.clamp">Read more</a></p>
|
||||
</div></div><h3 id="impl-PartialEq%3CNaiveDate%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html" title="trait core::cmp::PartialEq">PartialEq</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-PartialEq%3CNaiveDate%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.eq" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#tymethod.eq" class="fnname">eq</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
|
||||
by <code>==</code>. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#tymethod.eq">Read more</a></p>
|
||||
</div><h4 id="method.ne" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#method.ne" class="fnname">ne</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests for <code>!=</code>.</p>
|
||||
</div></div><h3 id="impl-PartialOrd%3CNaiveDate%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-PartialOrd%3CNaiveDate%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.partial_cmp" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp" class="fnname">partial_cmp</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="enum" href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a>></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp">Read more</a></p>
|
||||
</div><h4 id="method.lt" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.lt" class="fnname">lt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#963" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code><</code> operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.lt">Read more</a></p>
|
||||
</div><h4 id="method.le" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.le" class="fnname">le</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#982" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code><=</code>
|
||||
operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.le">Read more</a></p>
|
||||
</div><h4 id="method.gt" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.gt" class="fnname">gt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#1000" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>></code> operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.gt">Read more</a></p>
|
||||
</div><h4 id="method.ge" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.ge" class="fnname">ge</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#1019" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>>=</code>
|
||||
operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.ge">Read more</a></p>
|
||||
</div></div><h3 id="impl-StructuralEq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.StructuralEq.html" title="trait core::marker::StructuralEq">StructuralEq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-StructuralEq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-StructuralPartialEq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.StructuralPartialEq.html" title="trait core::marker::StructuralPartialEq">StructuralPartialEq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-StructuralPartialEq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#98" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-Sub%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Sub%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1509-1516" title="goto source code">[src]</a></h3><div class="docblock"><p>A subtraction of <code>Duration</code> from <code>NaiveDate</code> discards the fractional days,
|
||||
rounding to the closest integral number of days towards <code>Duration::zero()</code>.
|
||||
It is the same as the addition with a negated <code>Duration</code>.</p>
|
||||
<p>Panics on underflow or overflow.
|
||||
Use <a href="#method.checked_sub_signed"><code>NaiveDate::checked_sub_signed</code></a> to detect that.</p>
|
||||
<h1 id="example-47" class="section-header"><a href="#example-47">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">86399</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">86399</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">364</span>), <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">2</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">4</span> <span class="op">+</span> <span class="number">1</span>), <span class="ident">from_ymd</span>(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">400</span> <span class="op">+</span> <span class="number">97</span>), <span class="ident">from_ymd</span>(<span class="number">1614</span>, <span class="number">1</span>, <span class="number">1</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||||
</div><h4 id="method.sub" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">sub</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1513-1515" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||||
</div></div><h3 id="impl-Sub%3CNaiveDate%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Sub%3CNaiveDate%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1551-1558" title="goto source code">[src]</a></h3><div class="docblock"><p>Subtracts another <code>NaiveDate</code> from the current date.
|
||||
Returns a <code>Duration</code> of integral numbers.</p>
|
||||
<p>This does not overflow or underflow at all,
|
||||
as all possible output fits in the range of <code>Duration</code>.</p>
|
||||
<p>The implementation is a wrapper around
|
||||
<a href="#method.signed_duration_since"><code>NaiveDate::signed_duration_since</code></a>.</p>
|
||||
<h1 id="example-48" class="section-header"><a href="#example-48">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">Duration</span>::<span class="ident">zero</span>());
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">12</span>, <span class="number">31</span>), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">2</span>), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="op">-</span><span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">9</span>, <span class="number">23</span>), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">100</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2013</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2010</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">4</span> <span class="op">+</span> <span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">1</span>, <span class="number">1</span>) <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">1614</span>, <span class="number">1</span>, <span class="number">1</span>), <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span><span class="kw-2">*</span><span class="number">400</span> <span class="op">+</span> <span class="number">97</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output-1" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||||
</div><h4 id="method.sub-1" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">sub</a>(self, rhs: <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>) -> <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1555-1557" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||||
</div></div><h3 id="impl-SubAssign%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html" title="trait core::ops::arith::SubAssign">SubAssign</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-SubAssign%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/date.rs.html#1518-1523" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.sub_assign" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign" class="fnname">sub_assign</a>(&mut self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</code><a class="srclink" href="../../src/chrono/naive/date.rs.html#1520-1522" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-=</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign">Read more</a></p>
|
||||
</div></div></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><h3 id="impl-RefUnwindSafe" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/std/panic/trait.RefUnwindSafe.html" title="trait std::panic::RefUnwindSafe">RefUnwindSafe</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-RefUnwindSafe" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Send" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Send" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Sync" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Sync" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Unpin" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-Unpin" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-UnwindSafe" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html" title="trait std::panic::UnwindSafe">UnwindSafe</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a href="#impl-UnwindSafe" class="anchor"></a></h3><div class="impl-items"></div></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><h3 id="impl-Any" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T <span class="where fmt-newline">where<br> T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-Any" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#131-135" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.type_id" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html#tymethod.type_id" class="fnname">type_id</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/nightly/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#132" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html#tymethod.type_id">Read more</a></p>
|
||||
</div></div><h3 id="impl-Borrow%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-Borrow%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#207-211" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.borrow" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html#tymethod.borrow" class="fnname">borrow</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#208" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></p>
|
||||
</div></div><h3 id="impl-BorrowMut%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-BorrowMut%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#214-218" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.borrow_mut" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fnname">borrow_mut</a>(&mut self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#215" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></p>
|
||||
</div></div><h3 id="impl-From%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for T</code><a href="#impl-From%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#545-549" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html#tymethod.from" class="fnname">from</a>(t: T) -> T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#546" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-Into%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html" title="trait core::convert::From">From</a><T>, </span></code><a href="#impl-Into%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#534-541" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html#tymethod.into" class="fnname">into</a>(self) -> U</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#538" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-ToOwned" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>, </span></code><a href="#impl-ToOwned" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#81-93" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Owned" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="type">Owned</a> = T</code></h4><div class='docblock'><p>The resulting type after obtaining ownership.</p>
|
||||
</div><h4 id="method.to_owned" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fnname">to_owned</a>(&self) -> T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#86" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></p>
|
||||
</div><h4 id="method.clone_into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fnname">clone_into</a>(&self, target: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>T)</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#90" title="goto source code">[src]</a></h4><div class="item-info hidden"><div class="stab unstable"><details><summary><span class="emoji">🔬</span> This is a nightly-only experimental API. (<code>toowned_clone_into</code>)</summary><p>recently added</p>
|
||||
</details></div></div><div class='docblock hidden'><p>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></p>
|
||||
</div></div><h3 id="impl-ToString" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html" title="trait alloc::string::ToString">ToString</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-ToString" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/string.rs.html#2205-2218" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.to_string" class="method hidden"><code>pub default fn <a href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html#tymethod.to_string" class="fnname">to_string</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/nightly/alloc/string/struct.String.html" title="struct alloc::string::String">String</a></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/string.rs.html#2211" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Converts the given value to a <code>String</code>. <a href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html#tymethod.to_string">Read more</a></p>
|
||||
</div></div><h3 id="impl-TryFrom%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><T>, </span></code><a href="#impl-TryFrom%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#582-591" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Error" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" class="type">Error</a> = <a class="enum" href="https://doc.rust-lang.org/nightly/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></code></h4><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||||
</div><h4 id="method.try_from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#tymethod.try_from" class="fnname">try_from</a>(value: U) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a><T, <T as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#588" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-TryInto%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>, </span></code><a href="#impl-TryInto%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#568-577" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Error-1" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html#associatedtype.Error" class="type">Error</a> = <U as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></code></h4><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||||
</div><h4 id="method.try_into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html#tymethod.try_into" class="fnname">try_into</a>(self) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a><U, <U as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#574" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div></div></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,866 @@
|
||||
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="ISO 8601 combined date and time without timezone."><meta name="keywords" content="rust, rustlang, rust-lang, NaiveDateTime"><title>chrono::naive::NaiveDateTime - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc struct"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><p class="location">Struct NaiveDateTime</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#implementations">Methods</a><div class="sidebar-links"><a href="#method.checked_add_signed">checked_add_signed</a><a href="#method.checked_sub_signed">checked_sub_signed</a><a href="#method.date">date</a><a href="#method.format">format</a><a href="#method.format_with_items">format_with_items</a><a href="#method.from_timestamp">from_timestamp</a><a href="#method.from_timestamp_opt">from_timestamp_opt</a><a href="#method.new">new</a><a href="#method.parse_from_str">parse_from_str</a><a href="#method.signed_duration_since">signed_duration_since</a><a href="#method.time">time</a><a href="#method.timestamp">timestamp</a><a href="#method.timestamp_millis">timestamp_millis</a><a href="#method.timestamp_nanos">timestamp_nanos</a><a href="#method.timestamp_subsec_micros">timestamp_subsec_micros</a><a href="#method.timestamp_subsec_millis">timestamp_subsec_millis</a><a href="#method.timestamp_subsec_nanos">timestamp_subsec_nanos</a></div><a class="sidebar-title" href="#trait-implementations">Trait Implementations</a><div class="sidebar-links"><a href="#impl-Add%3CDuration%3E">Add<Duration></a><a href="#impl-Add%3CFixedOffset%3E">Add<FixedOffset></a><a href="#impl-AddAssign%3CDuration%3E">AddAssign<Duration></a><a href="#impl-Clone">Clone</a><a href="#impl-Copy">Copy</a><a href="#impl-Datelike">Datelike</a><a href="#impl-Debug">Debug</a><a href="#impl-Display">Display</a><a href="#impl-Eq">Eq</a><a href="#impl-FromStr">FromStr</a><a href="#impl-Hash">Hash</a><a href="#impl-Ord">Ord</a><a href="#impl-PartialEq%3CNaiveDateTime%3E">PartialEq<NaiveDateTime></a><a href="#impl-PartialOrd%3CNaiveDateTime%3E">PartialOrd<NaiveDateTime></a><a href="#impl-StructuralEq">StructuralEq</a><a href="#impl-StructuralPartialEq">StructuralPartialEq</a><a href="#impl-Sub%3CDuration%3E">Sub<Duration></a><a href="#impl-Sub%3CFixedOffset%3E">Sub<FixedOffset></a><a href="#impl-Sub%3CNaiveDateTime%3E">Sub<NaiveDateTime></a><a href="#impl-SubAssign%3CDuration%3E">SubAssign<Duration></a><a href="#impl-Timelike">Timelike</a></div><a class="sidebar-title" href="#synthetic-implementations">Auto Trait Implementations</a><div class="sidebar-links"><a href="#impl-RefUnwindSafe">RefUnwindSafe</a><a href="#impl-Send">Send</a><a href="#impl-Sync">Sync</a><a href="#impl-Unpin">Unpin</a><a href="#impl-UnwindSafe">UnwindSafe</a></div><a class="sidebar-title" href="#blanket-implementations">Blanket Implementations</a><div class="sidebar-links"><a href="#impl-Any">Any</a><a href="#impl-Borrow%3CT%3E">Borrow<T></a><a href="#impl-BorrowMut%3CT%3E">BorrowMut<T></a><a href="#impl-From%3CT%3E">From<T></a><a href="#impl-Into%3CU%3E">Into<U></a><a href="#impl-ToOwned">ToOwned</a><a href="#impl-ToString">ToString</a><a href="#impl-TryFrom%3CU%3E">TryFrom<U></a><a href="#impl-TryInto%3CU%3E">TryInto<U></a></div></div><p class="location"><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></p><div id="sidebar-vars" data-name="NaiveDateTime" data-ty="struct" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Struct <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="struct" href="">NaiveDateTime</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#62-65" title="goto source code">[src]</a></span></h1><div class="docblock type-decl hidden-by-usual-hider"><pre class="rust struct">pub struct NaiveDateTime { /* fields omitted */ }</pre></div><div class="docblock"><p>ISO 8601 combined date and time without timezone.</p>
|
||||
<h1 id="example" class="section-header"><a href="#example">Example</a></h1>
|
||||
<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">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>);</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">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Datelike</span>, <span class="ident">Timelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Fri</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">num_seconds_from_midnight</span>(), <span class="number">33011</span>);</pre></div>
|
||||
</div><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><h3 id="impl" class="impl"><code class="in-band">impl <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#67-700" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.new" class="method"><code>pub fn <a href="#method.new" class="fnname">new</a>(date: <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a>, time: <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#85-87" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-1" class="section-header"><a href="#example-1">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveTime</span>, <span class="ident">NaiveDateTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">3</span>);
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDateTime</span>::<span class="ident">new</span>(<span class="ident">d</span>, <span class="ident">t</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">date</span>(), <span class="ident">d</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">time</span>(), <span class="ident">t</span>);</pre></div>
|
||||
</div><h4 id="method.from_timestamp" class="method"><code>pub fn <a href="#method.from_timestamp" class="fnname">from_timestamp</a>(secs: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a>, nsecs: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#115-118" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> corresponding to a UTC date and time,
|
||||
from the number of non-leap seconds
|
||||
since the midnight UTC on January 1, 1970 (aka “UNIX timestamp”)
|
||||
and the number of nanoseconds since the last whole non-leap second.</p>
|
||||
<p>For a non-naive version of this function see
|
||||
<a href="../offset/trait.TimeZone.html#method.timestamp"><code>TimeZone::timestamp</code></a>.</p>
|
||||
<p>The nanosecond part can exceed 1,000,000,000 in order to represent the
|
||||
<a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>. (The true “UNIX
|
||||
timestamp” cannot represent a leap second unambiguously.)</p>
|
||||
<p>Panics on the out-of-range number of seconds and/or invalid nanosecond.</p>
|
||||
<h1 id="example-2" class="section-header"><a href="#example-2">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDateTime</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDateTime</span>::<span class="ident">from_timestamp</span>(<span class="number">0</span>, <span class="number">42_000_000</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">42</span>));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDateTime</span>::<span class="ident">from_timestamp</span>(<span class="number">1_000_000_000</span>, <span class="number">0</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>, <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>));</pre></div>
|
||||
</div><h4 id="method.from_timestamp_opt" class="method"><code>pub fn <a href="#method.from_timestamp_opt" class="fnname">from_timestamp_opt</a>(secs: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a>, nsecs: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#146-157" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> corresponding to a UTC date and time,
|
||||
from the number of non-leap seconds
|
||||
since the midnight UTC on January 1, 1970 (aka “UNIX timestamp”)
|
||||
and the number of nanoseconds since the last whole non-leap second.</p>
|
||||
<p>The nanosecond part can exceed 1,000,000,000
|
||||
in order to represent the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.
|
||||
(The true “UNIX timestamp” cannot represent a leap second unambiguously.)</p>
|
||||
<p>Returns <code>None</code> on the out-of-range number of seconds and/or invalid nanosecond.</p>
|
||||
<h1 id="example-3" class="section-header"><a href="#example-3">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDateTime</span>, <span class="ident">NaiveDate</span>};
|
||||
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">i64</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_timestamp_opt</span> <span class="op">=</span> <span class="ident">NaiveDateTime</span>::<span class="ident">from_timestamp_opt</span>;
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_timestamp_opt</span>(<span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_timestamp_opt</span>(<span class="number">0</span>, <span class="number">999_999_999</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_timestamp_opt</span>(<span class="number">0</span>, <span class="number">1_500_000_000</span>).<span class="ident">is_some</span>()); <span class="comment">// leap second</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_timestamp_opt</span>(<span class="number">0</span>, <span class="number">2_000_000_000</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_timestamp_opt</span>(<span class="ident">i64</span>::<span class="ident">MAX</span>, <span class="number">0</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.parse_from_str" class="method"><code>pub fn <a href="#method.parse_from_str" class="fnname">parse_from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>, fmt: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="type" href="../../chrono/format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#220-224" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-4" class="section-header"><a href="#example-4">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDateTime</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">parse_from_str</span> <span class="op">=</span> <span class="ident">NaiveDateTime</span>::<span class="ident">parse_from_str</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<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>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"5sep2015pm012345.6789"</span>, <span class="string">"%d%b%Y%p%I%M%S%.f"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).<span class="ident">and_hms_micro</span>(<span class="number">13</span>, <span class="number">23</span>, <span class="number">45</span>, <span class="number">678_900</span>)));</pre></div>
|
||||
<p>Offset is ignored for the purpose of parsing.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2014-5-17T12:34:56+09:30"</span>, <span class="string">"%Y-%m-%dT%H:%M:%S%z"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2014</span>, <span class="number">5</span>, <span class="number">17</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<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>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms_milli</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_123</span>)));</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"94/9/4 7:15"</span>, <span class="string">"%y/%m/%d %H:%M"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1994</span>, <span class="number">9</span>, <span class="number">4</span>).<span class="ident">and_hms</span>(<span class="number">7</span>, <span class="number">15</span>, <span class="number">0</span>)));
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"04m33s"</span>, <span class="string">"%Mm%Ss"</span>).<span class="ident">is_err</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"94/9/4 12"</span>, <span class="string">"%y/%m/%d %H"</span>).<span class="ident">is_err</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"94/9/4 17:60"</span>, <span class="string">"%y/%m/%d %H:%M"</span>).<span class="ident">is_err</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"94/9/4 24:00:00"</span>, <span class="string">"%y/%m/%d %H:%M:%S"</span>).<span class="ident">is_err</span>());</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">
|
||||
<span class="kw">let</span> <span class="ident">fmt</span> <span class="op">=</span> <span class="string">"%Y-%m-%d %H:%M:%S = UNIX timestamp %s"</span>;
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2001-09-09 01:46:39 = UNIX timestamp 999999999"</span>, <span class="ident">fmt</span>).<span class="ident">is_ok</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"1970-01-01 00:00:00 = UNIX timestamp 1"</span>, <span class="ident">fmt</span>).<span class="ident">is_err</span>());</pre></div>
|
||||
</div><h4 id="method.date" class="method"><code>pub fn <a href="#method.date" class="fnname">date</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.NaiveDate.html" title="struct chrono::naive::NaiveDate">NaiveDate</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#237-239" title="goto source code">[src]</a></h4><div class="docblock"><p>Retrieves a date component.</p>
|
||||
<h1 id="example-5" class="section-header"><a href="#example-5">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">date</span>(), <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>));</pre></div>
|
||||
</div><h4 id="method.time" class="method"><code>pub fn <a href="#method.time" class="fnname">time</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#252-254" title="goto source code">[src]</a></h4><div class="docblock"><p>Retrieves a time component.</p>
|
||||
<h1 id="example-6" class="section-header"><a href="#example-6">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">time</span>(), <span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>));</pre></div>
|
||||
</div><h4 id="method.timestamp" class="method"><code>pub fn <a href="#method.timestamp" class="fnname">timestamp</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#279-284" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-7" class="section-header"><a href="#example-7">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">980</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp</span>(), <span class="number">1</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp</span>(), <span class="number">1_000_000_000</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1969</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp</span>(), <span class="op">-</span><span class="number">1</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">1</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp</span>(), <span class="op">-</span><span class="number">62198755200</span>);</pre></div>
|
||||
</div><h4 id="method.timestamp_millis" class="method"><code>pub fn <a href="#method.timestamp_millis" class="fnname">timestamp_millis</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#311-314" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the number of non-leap <em>milliseconds</em> since midnight on January 1, 1970.</p>
|
||||
<p>Note that this does <em>not</em> account for the timezone!
|
||||
The true “UNIX timestamp” would count seconds since the midnight <em>UTC</em> on the epoch.</p>
|
||||
<p>Note also that this does reduce the number of years that can be
|
||||
represented from ~584 Billion to ~584 Million. (If this is a problem,
|
||||
please file an issue to let me know what domain needs millisecond
|
||||
precision over billions of years, I’m curious.)</p>
|
||||
<h1 id="example-8" class="section-header"><a href="#example-8">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">444</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_millis</span>(), <span class="number">1_444</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).<span class="ident">and_hms_milli</span>(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>, <span class="number">555</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_millis</span>(), <span class="number">1_000_000_000_555</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1969</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">100</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_millis</span>(), <span class="op">-</span><span class="number">900</span>);</pre></div>
|
||||
</div><h4 id="method.timestamp_nanos" class="method"><code>pub fn <a href="#method.timestamp_nanos" class="fnname">timestamp_nanos</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#350-353" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="panics" class="section-header"><a href="#panics">Panics</a></h1>
|
||||
<p>Note also that this does reduce the number of years that can be
|
||||
represented from ~584 Billion to ~584 years. The dates that can be
|
||||
represented as nanoseconds are between 1677-09-21T00:12:44.0 and
|
||||
2262-04-11T23:47:16.854775804.</p>
|
||||
<p>(If this is a problem, please file an issue to let me know what domain
|
||||
needs nanosecond precision over millennia, I’m curious.)</p>
|
||||
<h1 id="example-9" class="section-header"><a href="#example-9">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">1970</span>, <span class="number">1</span>, <span class="number">1</span>).<span class="ident">and_hms_nano</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">1</span>, <span class="number">444</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_nanos</span>(), <span class="number">1_000_000_444</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2001</span>, <span class="number">9</span>, <span class="number">9</span>).<span class="ident">and_hms_nano</span>(<span class="number">1</span>, <span class="number">46</span>, <span class="number">40</span>, <span class="number">555</span>);
|
||||
|
||||
<span class="kw">const</span> <span class="ident">A_BILLION</span>: <span class="ident">i64</span> <span class="op">=</span> <span class="number">1_000_000_000</span>;
|
||||
<span class="kw">let</span> <span class="ident">nanos</span> <span class="op">=</span> <span class="ident">dt</span>.<span class="ident">timestamp_nanos</span>();
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">nanos</span>, <span class="number">1_000_000_000_000_000_555</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(
|
||||
<span class="ident">dt</span>,
|
||||
<span class="ident">NaiveDateTime</span>::<span class="ident">from_timestamp</span>(<span class="ident">nanos</span> <span class="op">/</span> <span class="ident">A_BILLION</span>, (<span class="ident">nanos</span> <span class="op">%</span> <span class="ident">A_BILLION</span>) <span class="kw">as</span> <span class="ident">u32</span>)
|
||||
);</pre></div>
|
||||
</div><h4 id="method.timestamp_subsec_millis" class="method"><code>pub fn <a href="#method.timestamp_subsec_millis" class="fnname">timestamp_subsec_millis</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#372-374" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-10" class="section-header"><a href="#example-10">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms_nano</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_millis</span>(), <span class="number">123</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms_nano</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_millis</span>(), <span class="number">1_234</span>);</pre></div>
|
||||
</div><h4 id="method.timestamp_subsec_micros" class="method"><code>pub fn <a href="#method.timestamp_subsec_micros" class="fnname">timestamp_subsec_micros</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#393-395" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-11" class="section-header"><a href="#example-11">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms_nano</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_micros</span>(), <span class="number">123_456</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms_nano</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_micros</span>(), <span class="number">1_234_567</span>);</pre></div>
|
||||
</div><h4 id="method.timestamp_subsec_nanos" class="method"><code>pub fn <a href="#method.timestamp_subsec_nanos" class="fnname">timestamp_subsec_nanos</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#414-416" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-12" class="section-header"><a href="#example-12">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms_nano</span>(<span class="number">9</span>, <span class="number">10</span>, <span class="number">11</span>, <span class="number">123_456_789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_nanos</span>(), <span class="number">123_456_789</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms_nano</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">timestamp_subsec_nanos</span>(), <span class="number">1_234_567_890</span>);</pre></div>
|
||||
</div><h4 id="method.checked_add_signed" class="method"><code>pub fn <a href="#method.checked_add_signed" class="fnname">checked_add_signed</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#489-499" title="goto source code">[src]</a></h4><div class="docblock"><p>Adds given <code>Duration</code> to the current date and time.</p>
|
||||
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
|
||||
the addition assumes that <strong>there is no leap second ever</strong>,
|
||||
except when the <code>NaiveDateTime</code> itself represents a leap second
|
||||
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
|
||||
<p>Returns <code>None</code> when it will result in overflow.</p>
|
||||
<h1 id="example-13" class="section-header"><a href="#example-13">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
|
||||
<span class="kw">let</span> <span class="ident">hms</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">zero</span>()),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">1</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">4</span>, <span class="number">6</span>, <span class="number">7</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">86_400</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">hmsm</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">980</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">450</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>, <span class="number">430</span>)));</pre></div>
|
||||
<p>Overflow returns <code>None</code>.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);</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">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">zero</span>()),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="op">-</span><span class="number">500</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_800</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">800</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">100</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">10</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">9</span>, <span class="number">300</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">10</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">50</span>, <span class="number">300</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms_milli</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">300</span>)));</pre></div>
|
||||
</div><h4 id="method.checked_sub_signed" class="method"><code>pub fn <a href="#method.checked_sub_signed" class="fnname">checked_sub_signed</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#568-578" title="goto source code">[src]</a></h4><div class="docblock"><p>Subtracts given <code>Duration</code> from the current date and time.</p>
|
||||
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
|
||||
the subtraction assumes that <strong>there is no leap second ever</strong>,
|
||||
except when the <code>NaiveDateTime</code> itself represents a leap second
|
||||
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
|
||||
<p>Returns <code>None</code> when it will result in overflow.</p>
|
||||
<h1 id="example-14" class="section-header"><a href="#example-14">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
|
||||
<span class="kw">let</span> <span class="ident">hms</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">zero</span>()),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">1</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">7</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">86_400</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>)));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">hmsm</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">450</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">670</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">780</span>)));</pre></div>
|
||||
<p>Overflow returns <code>None</code>.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1_000_000_000</span>)), <span class="prelude-val">None</span>);</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">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">zero</span>()),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">200</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_100</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">60</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">0</span>, <span class="number">300</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">checked_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>)),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).<span class="ident">and_hms_milli</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">300</span>)));</pre></div>
|
||||
</div><h4 id="method.signed_duration_since" class="method"><code>pub fn <a href="#method.signed_duration_since" class="fnname">signed_duration_since</a>(self, rhs: <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#622-624" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-15" class="section-header"><a href="#example-15">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>).<span class="ident">signed_duration_since</span>(<span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">6</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span> <span class="op">+</span> <span class="number">1</span>));
|
||||
|
||||
<span class="comment">// July 8 is 190th day in the year 2016</span>
|
||||
<span class="kw">let</span> <span class="ident">d0</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">7</span>, <span class="number">6</span>, <span class="number">500</span>).<span class="ident">signed_duration_since</span>(<span class="ident">d0</span>.<span class="ident">and_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">189</span> <span class="op">*</span> <span class="number">86_400</span> <span class="op">+</span> <span class="number">7</span> <span class="op">*</span> <span class="number">60</span> <span class="op">+</span> <span class="number">6</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>));</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">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">signed_duration_since</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">0</span>, <span class="number">0</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms</span>(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">signed_duration_since</span>(<span class="ident">leap</span>),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>));</pre></div>
|
||||
</div><h4 id="method.format_with_items" class="method"><code>pub fn <a href="#method.format_with_items" class="fnname">format_with_items</a><'a, I, B>(&self, items: I) -> <a class="struct" href="../../chrono/format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><I> <span class="where fmt-newline">where<br> I: <a class="trait" href="https://doc.rust-lang.org/nightly/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/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,<br> B: <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><<a class="enum" href="../../chrono/format/enum.Item.html" title="enum chrono::format::Item">Item</a><'a>>, </span></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#655-661" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-16" class="section-header"><a href="#example-16">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">format</span>::<span class="ident">strftime</span>::<span class="ident">StrftimeItems</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">fmt</span> <span class="op">=</span> <span class="ident">StrftimeItems</span>::<span class="ident">new</span>(<span class="string">"%Y-%m-%d %H:%M:%S"</span>);
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>.<span class="ident">clone</span>()).<span class="ident">to_string</span>(), <span class="string">"2015-09-05 23:56:04"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">"%Y-%m-%d %H:%M:%S"</span>).<span class="ident">to_string</span>(), <span class="string">"2015-09-05 23:56:04"</span>);</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">dt</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>)), <span class="string">"2015-09-05 23:56:04"</span>);</pre></div>
|
||||
</div><h4 id="method.format" class="method"><code>pub fn <a href="#method.format" class="fnname">format</a><'a>(&self, fmt: &'a <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="struct" href="../../chrono/format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><<a class="struct" href="../../chrono/format/strftime/struct.StrftimeItems.html" title="struct chrono::format::strftime::StrftimeItems">StrftimeItems</a><'a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#697-699" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-17" class="section-header"><a href="#example-17">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">5</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">"%Y-%m-%d %H:%M:%S"</span>).<span class="ident">to_string</span>(), <span class="string">"2015-09-05 23:56:04"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">"around %l %p on %b %-d"</span>).<span class="ident">to_string</span>(), <span class="string">"around 11 PM on Sep 5"</span>);</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">dt</span>.<span class="ident">format</span>(<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">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">dt</span>.<span class="ident">format</span>(<span class="string">"around %l %p on %b %-d"</span>)), <span class="string">"around 11 PM on Sep 5"</span>);</pre></div>
|
||||
</div></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><h3 id="impl-Add%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Add%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1252-1259" title="goto source code">[src]</a></h3><div class="docblock"><p>An addition of <code>Duration</code> to <code>NaiveDateTime</code> yields another <code>NaiveDateTime</code>.</p>
|
||||
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
|
||||
the addition assumes that <strong>there is no leap second ever</strong>,
|
||||
except when the <code>NaiveDateTime</code> itself represents a leap second
|
||||
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
|
||||
<p>Panics on underflow or overflow.
|
||||
Use <a href="#method.checked_add_signed"><code>NaiveDateTime::checked_add_signed</code></a> to detect that.</p>
|
||||
<h1 id="example-45" class="section-header"><a href="#example-45">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
|
||||
<span class="kw">let</span> <span class="ident">hms</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span>), <span class="ident">hms</span>(<span class="number">4</span>, <span class="number">6</span>, <span class="number">7</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">86_400</span>),
|
||||
<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span>),
|
||||
<span class="ident">from_ymd</span>(<span class="number">2017</span>, <span class="number">7</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">hmsm</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">980</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">450</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>, <span class="number">430</span>));</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">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="op">-</span><span class="number">500</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_800</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">800</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">100</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">10</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">9</span>, <span class="number">300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">10</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">50</span>, <span class="number">300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>),
|
||||
<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms_milli</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">300</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output-4" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>+</code> operator.</p>
|
||||
</div><h4 id="method.add-1" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add" class="fnname">add</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1256-1258" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></p>
|
||||
</div></div><h3 id="impl-Add%3CFixedOffset%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../../chrono/offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Add%3CFixedOffset%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#182-189" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Output-3" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>+</code> operator.</p>
|
||||
</div><h4 id="method.add" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add" class="fnname">add</a>(self, rhs: <a class="struct" href="../../chrono/offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#186-188" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></p>
|
||||
</div></div><h3 id="impl-AddAssign%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html" title="trait core::ops::arith::AddAssign">AddAssign</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-AddAssign%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1261-1266" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.add_assign" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html#tymethod.add_assign" class="fnname">add_assign</a>(&mut self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1263-1265" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>+=</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html#tymethod.add_assign">Read more</a></p>
|
||||
</div></div><h3 id="impl-Clone" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Clone" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.clone" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone" class="fnname">clone</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns a copy of the value. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone">Read more</a></p>
|
||||
</div><h4 id="method.clone_from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from" class="fnname">clone_from</a>(&mut self, source: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Self)</code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/clone.rs.html#128" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from">Read more</a></p>
|
||||
</div></div><h3 id="impl-Copy" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Copy.html" title="trait core::marker::Copy">Copy</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Copy" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-Datelike" class="impl"><code class="in-band">impl <a class="trait" href="../../chrono/trait.Datelike.html" title="trait chrono::Datelike">Datelike</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Datelike" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#702-1018" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.year" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.year" class="fnname">year</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#716-718" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the year number in the <a href="./index.html#calendar-date">calendar date</a>.</p>
|
||||
<p>See also the <a href="./struct.NaiveDate.html#method.year"><code>NaiveDate::year</code></a> method.</p>
|
||||
<h1 id="example-18" class="section-header"><a href="#example-18">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">year</span>(), <span class="number">2015</span>);</pre></div>
|
||||
</div><h4 id="method.month" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.month" class="fnname">month</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#735-737" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-19" class="section-header"><a href="#example-19">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">month</span>(), <span class="number">9</span>);</pre></div>
|
||||
</div><h4 id="method.month0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.month0" class="fnname">month0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#754-756" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-20" class="section-header"><a href="#example-20">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">month0</span>(), <span class="number">8</span>);</pre></div>
|
||||
</div><h4 id="method.day" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.day" class="fnname">day</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#773-775" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-21" class="section-header"><a href="#example-21">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">day</span>(), <span class="number">25</span>);</pre></div>
|
||||
</div><h4 id="method.day0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.day0" class="fnname">day0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#792-794" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-22" class="section-header"><a href="#example-22">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">day0</span>(), <span class="number">24</span>);</pre></div>
|
||||
</div><h4 id="method.ordinal" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.ordinal" class="fnname">ordinal</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#811-813" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-23" class="section-header"><a href="#example-23">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">ordinal</span>(), <span class="number">268</span>);</pre></div>
|
||||
</div><h4 id="method.ordinal0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.ordinal0" class="fnname">ordinal0</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#830-832" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-24" class="section-header"><a href="#example-24">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">ordinal0</span>(), <span class="number">267</span>);</pre></div>
|
||||
</div><h4 id="method.weekday" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.weekday" class="fnname">weekday</a>(&self) -> <a class="enum" href="../../chrono/enum.Weekday.html" title="enum chrono::Weekday">Weekday</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#847-849" title="goto source code">[src]</a></h4><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>
|
||||
<h1 id="example-25" class="section-header"><a href="#example-25">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>, <span class="ident">Weekday</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">weekday</span>(), <span class="ident">Weekday</span>::<span class="ident">Fri</span>);</pre></div>
|
||||
</div><h4 id="method.iso_week" class="method hidden"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.iso_week" class="fnname">iso_week</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.IsoWeek.html" title="struct chrono::naive::IsoWeek">IsoWeek</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#852-854" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns the ISO week.</p>
|
||||
</div><h4 id="method.with_year" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_year" class="fnname">with_year</a>(&self, year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#873-875" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the year number changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveDate.html#method.with_year"><code>NaiveDate::with_year</code></a> method.</p>
|
||||
<h1 id="example-26" class="section-header"><a href="#example-26">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_year</span>(<span class="number">2016</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_year</span>(<span class="op">-</span><span class="number">308</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="op">-</span><span class="number">308</span>, <span class="number">9</span>, <span class="number">25</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));</pre></div>
|
||||
</div><h4 id="method.with_month" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_month" class="fnname">with_month</a>(&self, month: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#895-897" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the month number (starting from 1) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveDate.html#method.with_month"><code>NaiveDate::with_month</code></a> method.</p>
|
||||
<h1 id="example-27" class="section-header"><a href="#example-27">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_month</span>(<span class="number">10</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_month</span>(<span class="number">13</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_month</span>(<span class="number">2</span>), <span class="prelude-val">None</span>); <span class="comment">// no February 30</span></pre></div>
|
||||
</div><h4 id="method.with_month0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_month0" class="fnname">with_month0</a>(&self, month0: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#917-919" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the month number (starting from 0) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveDate.html#method.with_month0"><code>NaiveDate::with_month0</code></a> method.</p>
|
||||
<h1 id="example-28" class="section-header"><a href="#example-28">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_month0</span>(<span class="number">9</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">10</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_month0</span>(<span class="number">12</span>), <span class="prelude-val">None</span>); <span class="comment">// no month 13</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_month0</span>(<span class="number">1</span>), <span class="prelude-val">None</span>); <span class="comment">// no February 30</span></pre></div>
|
||||
</div><h4 id="method.with_day" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_day" class="fnname">with_day</a>(&self, day: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#938-940" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of month (starting from 1) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveDate.html#method.with_day"><code>NaiveDate::with_day</code></a> method.</p>
|
||||
<h1 id="example-29" class="section-header"><a href="#example-29">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_day</span>(<span class="number">30</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_day</span>(<span class="number">31</span>), <span class="prelude-val">None</span>); <span class="comment">// no September 31</span></pre></div>
|
||||
</div><h4 id="method.with_day0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_day0" class="fnname">with_day0</a>(&self, day0: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#959-961" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of month (starting from 0) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveDate.html#method.with_day0"><code>NaiveDate::with_day0</code></a> method.</p>
|
||||
<h1 id="example-30" class="section-header"><a href="#example-30">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_day0</span>(<span class="number">29</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_day0</span>(<span class="number">30</span>), <span class="prelude-val">None</span>); <span class="comment">// no September 31</span></pre></div>
|
||||
</div><h4 id="method.with_ordinal" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_ordinal" class="fnname">with_ordinal</a>(&self, ordinal: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#987-989" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of year (starting from 1) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveDate.html#method.with_ordinal"><code>NaiveDate::with_ordinal</code></a> method.</p>
|
||||
<h1 id="example-31" class="section-header"><a href="#example-31">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_ordinal</span>(<span class="number">60</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_ordinal</span>(<span class="number">366</span>), <span class="prelude-val">None</span>); <span class="comment">// 2015 had only 365 days</span>
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_ordinal</span>(<span class="number">60</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_ordinal</span>(<span class="number">366</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));</pre></div>
|
||||
</div><h4 id="method.with_ordinal0" class="method"><code>fn <a href="../../chrono/trait.Datelike.html#tymethod.with_ordinal0" class="fnname">with_ordinal0</a>(&self, ordinal0: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1015-1017" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the day of year (starting from 0) changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveDate.html#method.with_ordinal0"><code>NaiveDate::with_ordinal0</code></a> method.</p>
|
||||
<h1 id="example-32" class="section-header"><a href="#example-32">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Datelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_ordinal0</span>(<span class="number">59</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">3</span>, <span class="number">1</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_ordinal0</span>(<span class="number">365</span>), <span class="prelude-val">None</span>); <span class="comment">// 2015 had only 365 days</span>
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_ordinal0</span>(<span class="number">59</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">2</span>, <span class="number">29</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_ordinal0</span>(<span class="number">365</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">12</span>, <span class="number">31</span>).<span class="ident">and_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));</pre></div>
|
||||
</div><h4 id="method.year_ce" class="method hidden"><code>fn <a href="../../chrono/trait.Datelike.html#method.year_ce" class="fnname">year_ce</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code><a class="srclink" href="../../src/chrono/lib.rs.html#1252-1259" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns the absolute year number starting from 1 with a boolean flag,
|
||||
which is false when the year predates the epoch (BCE/BC) and true otherwise (CE/AD). <a href="../../chrono/trait.Datelike.html#method.year_ce">Read more</a></p>
|
||||
</div><h4 id="method.num_days_from_ce" class="method hidden"><code>fn <a href="../../chrono/trait.Datelike.html#method.num_days_from_ce" class="fnname">num_days_from_ce</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a></code><a class="srclink" href="../../src/chrono/lib.rs.html#1344-1359" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Counts the days in the proleptic Gregorian calendar, with January 1, Year 1 (CE) as day 1. <a href="../../chrono/trait.Datelike.html#method.num_days_from_ce">Read more</a></p>
|
||||
</div></div><h3 id="impl-Debug" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Debug" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1416-1420" title="goto source code">[src]</a></h3><div class="docblock"><p>The <code>Debug</code> output of the naive date and time <code>dt</code> is the same as
|
||||
<a href="../format/strftime/index.html"><code>dt.format("%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>
|
||||
<h1 id="example-41" class="section-header"><a href="#example-41">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">11</span>, <span class="number">15</span>).<span class="ident">and_hms</span>(<span class="number">7</span>, <span class="number">39</span>, <span class="number">24</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">dt</span>), <span class="string">"2016-11-15T07:39:24"</span>);</pre></div>
|
||||
<p>Leap seconds may also be used.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">dt</span>), <span class="string">"2015-06-30T23:59:60.500"</span>);</pre></div>
|
||||
</div><div class="impl-items"><h4 id="method.fmt" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/nightly/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1417-1419" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></p>
|
||||
</div></div><h3 id="impl-Display" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Display" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1447-1451" title="goto source code">[src]</a></h3><div class="docblock"><p>The <code>Display</code> output of the naive date and time <code>dt</code> is the same as
|
||||
<a href="../format/strftime/index.html"><code>dt.format("%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>
|
||||
<h1 id="example-42" class="section-header"><a href="#example-42">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveDate</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">11</span>, <span class="number">15</span>).<span class="ident">and_hms</span>(<span class="number">7</span>, <span class="number">39</span>, <span class="number">24</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">dt</span>), <span class="string">"2016-11-15 07:39:24"</span>);</pre></div>
|
||||
<p>Leap seconds may also be used.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">dt</span>), <span class="string">"2015-06-30 23:59:60.500"</span>);</pre></div>
|
||||
</div><div class="impl-items"><h4 id="method.fmt-1" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/nightly/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1448-1450" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html#tymethod.fmt">Read more</a></p>
|
||||
</div></div><h3 id="impl-Eq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Eq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-FromStr" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html" title="trait core::str::traits::FromStr">FromStr</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-FromStr" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1469-1498" title="goto source code">[src]</a></h3><div class="docblock"><p>Parsing a <code>str</code> into a <code>NaiveDateTime</code> uses the same format,
|
||||
<a href="../format/strftime/index.html"><code>%Y-%m-%dT%H:%M:%S%.f</code></a>, as in <code>Debug</code>.</p>
|
||||
<h1 id="example-46" class="section-header"><a href="#example-46">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDateTime</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">18</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="string">"2015-09-18T23:56:04"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDateTime</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">dt</span>));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">12345</span>, <span class="number">6</span>, <span class="number">7</span>).<span class="ident">and_hms_milli</span>(<span class="number">7</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>); <span class="comment">// leap second</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="string">"+12345-6-7T7:59:60.5"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDateTime</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">dt</span>));
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="string">"foo"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveDateTime</span><span class="op">></span>().<span class="ident">is_err</span>());</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Err" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#associatedtype.Err" class="type">Err</a> = <a class="struct" href="../../chrono/format/struct.ParseError.html" title="struct chrono::format::ParseError">ParseError</a></code></h4><div class='docblock'><p>The associated error which can be returned from parsing.</p>
|
||||
</div><h4 id="method.from_str" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#tymethod.from_str" class="fnname">from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="type" href="../../chrono/format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1472-1497" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Parses a string <code>s</code> to return a value of this type. <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#tymethod.from_str">Read more</a></p>
|
||||
</div></div><h3 id="impl-Hash" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Hash" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1192-1197" title="goto source code">[src]</a></h3><div class="docblock"><p><code>NaiveDateTime</code> can be used as a key to the hash maps (in principle).</p>
|
||||
<p>Practically this also takes account of fractional seconds, so it is not recommended.
|
||||
(For the obvious reason this also distinguishes leap seconds from non-leap seconds.)</p>
|
||||
</div><div class="impl-items"><h4 id="method.hash" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#tymethod.hash" class="fnname">hash</a><H: <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>>(&self, state: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>H)</code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1193-1196" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Feeds this value into the given <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#tymethod.hash">Read more</a></p>
|
||||
</div><h4 id="method.hash_slice" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#method.hash_slice" class="fnname">hash_slice</a><H>(data: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&[Self]</a>, state: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>H) <span class="where fmt-newline">where<br> H: <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>, </span></code><span class="since" title="Stable since Rust version 1.3.0">1.3.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/hash/mod.rs.html#184-186" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Feeds a slice of this type into the given <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#method.hash_slice">Read more</a></p>
|
||||
</div></div><h3 id="impl-Ord" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html" title="trait core::cmp::Ord">Ord</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Ord" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.cmp" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#tymethod.cmp" class="fnname">cmp</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method returns an <a href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="Ordering"><code>Ordering</code></a> between <code>self</code> and <code>other</code>. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#tymethod.cmp">Read more</a></p>
|
||||
</div><h4 id="method.max" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.max" class="fnname">max</a>(self, other: Self) -> Self</code><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#723-725" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Compares and returns the maximum of two values. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.max">Read more</a></p>
|
||||
</div><h4 id="method.min" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.min" class="fnname">min</a>(self, other: Self) -> Self</code><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#743-745" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Compares and returns the minimum of two values. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.min">Read more</a></p>
|
||||
</div><h4 id="method.clamp" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.clamp" class="fnname">clamp</a>(self, min: Self, max: Self) -> Self</code><span class="since" title="Stable since Rust version 1.50.0">1.50.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#768-770" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Restrict a value to a certain interval. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.clamp">Read more</a></p>
|
||||
</div></div><h3 id="impl-PartialEq%3CNaiveDateTime%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html" title="trait core::cmp::PartialEq">PartialEq</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-PartialEq%3CNaiveDateTime%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.eq" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#tymethod.eq" class="fnname">eq</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
|
||||
by <code>==</code>. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#tymethod.eq">Read more</a></p>
|
||||
</div><h4 id="method.ne" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#method.ne" class="fnname">ne</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests for <code>!=</code>.</p>
|
||||
</div></div><h3 id="impl-PartialOrd%3CNaiveDateTime%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-PartialOrd%3CNaiveDateTime%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.partial_cmp" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp" class="fnname">partial_cmp</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="enum" href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp">Read more</a></p>
|
||||
</div><h4 id="method.lt" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.lt" class="fnname">lt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#963" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code><</code> operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.lt">Read more</a></p>
|
||||
</div><h4 id="method.le" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.le" class="fnname">le</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#982" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code><=</code>
|
||||
operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.le">Read more</a></p>
|
||||
</div><h4 id="method.gt" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.gt" class="fnname">gt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#1000" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>></code> operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.gt">Read more</a></p>
|
||||
</div><h4 id="method.ge" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.ge" class="fnname">ge</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#1019" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>>=</code>
|
||||
operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.ge">Read more</a></p>
|
||||
</div></div><h3 id="impl-StructuralEq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.StructuralEq.html" title="trait core::marker::StructuralEq">StructuralEq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-StructuralEq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-StructuralPartialEq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.StructuralPartialEq.html" title="trait core::marker::StructuralPartialEq">StructuralPartialEq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-StructuralPartialEq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#61" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-Sub%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Sub%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1320-1327" title="goto source code">[src]</a></h3><div class="docblock"><p>A subtraction of <code>Duration</code> from <code>NaiveDateTime</code> yields another <code>NaiveDateTime</code>.
|
||||
It is the same as the addition with a negated <code>Duration</code>.</p>
|
||||
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
|
||||
the addition assumes that <strong>there is no leap second ever</strong>,
|
||||
except when the <code>NaiveDateTime</code> itself represents a leap second
|
||||
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
|
||||
<p>Panics on underflow or overflow.
|
||||
Use <a href="#method.checked_sub_signed"><code>NaiveDateTime::checked_sub_signed</code></a> to detect that.</p>
|
||||
<h1 id="example-43" class="section-header"><a href="#example-43">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
|
||||
<span class="kw">let</span> <span class="ident">hms</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span>), <span class="ident">hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">7</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">86_400</span>),
|
||||
<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">365</span>),
|
||||
<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">9</span>).<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">hmsm</span> <span class="op">=</span> <span class="op">|</span><span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span><span class="op">|</span> <span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="ident">h</span>, <span class="ident">m</span>, <span class="ident">s</span>, <span class="ident">milli</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">450</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">670</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">780</span>));</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">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">200</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_100</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">60</span>), <span class="ident">hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">0</span>, <span class="number">300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>),
|
||||
<span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">7</span>).<span class="ident">and_hms_milli</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">300</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output-1" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||||
</div><h4 id="method.sub-1" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">sub</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1324-1326" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||||
</div></div><h3 id="impl-Sub%3CFixedOffset%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../../chrono/offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Sub%3CFixedOffset%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#191-198" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Output" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||||
</div><h4 id="method.sub" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">sub</a>(self, rhs: <a class="struct" href="../../chrono/offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#195-197" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||||
</div></div><h3 id="impl-Sub%3CNaiveDateTime%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Sub%3CNaiveDateTime%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1380-1387" title="goto source code">[src]</a></h3><div class="docblock"><p>Subtracts another <code>NaiveDateTime</code> from the current date and time.
|
||||
This does not overflow or underflow at all.</p>
|
||||
<p>As a part of Chrono’s <a href="./struct.NaiveTime.html#leap-second-handling">leap second handling</a>,
|
||||
the subtraction assumes that <strong>there is no leap second ever</strong>,
|
||||
except when any of the <code>NaiveDateTime</code>s themselves represents a leap second
|
||||
in which case the assumption becomes that
|
||||
<strong>there are exactly one (or two) leap second(s) ever</strong>.</p>
|
||||
<p>The implementation is a wrapper around
|
||||
<a href="#method.signed_duration_since"><code>NaiveDateTime::signed_duration_since</code></a>.</p>
|
||||
<h1 id="example-44" class="section-header"><a href="#example-44">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveDate</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_ymd</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">d</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">7</span>, <span class="number">8</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>) <span class="op">-</span> <span class="ident">d</span>.<span class="ident">and_hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">6</span>), <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span> <span class="op">+</span> <span class="number">1</span>));
|
||||
|
||||
<span class="comment">// July 8 is 190th day in the year 2016</span>
|
||||
<span class="kw">let</span> <span class="ident">d0</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2016</span>, <span class="number">1</span>, <span class="number">1</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">d</span>.<span class="ident">and_hms_milli</span>(<span class="number">0</span>, <span class="number">7</span>, <span class="number">6</span>, <span class="number">500</span>) <span class="op">-</span> <span class="ident">d0</span>.<span class="ident">and_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">189</span> <span class="op">*</span> <span class="number">86_400</span> <span class="op">+</span> <span class="number">7</span> <span class="op">*</span> <span class="number">60</span> <span class="op">+</span> <span class="number">6</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>));</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">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">0</span>, <span class="number">0</span>),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms</span>(<span class="number">1</span>, <span class="number">0</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">leap</span>,
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output-2" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||||
</div><h4 id="method.sub-2" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">sub</a>(self, rhs: <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>) -> <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1384-1386" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||||
</div></div><h3 id="impl-SubAssign%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html" title="trait core::ops::arith::SubAssign">SubAssign</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-SubAssign%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1329-1334" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.sub_assign" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign" class="fnname">sub_assign</a>(&mut self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1331-1333" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-=</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign">Read more</a></p>
|
||||
</div></div><h3 id="impl-Timelike" class="impl"><code class="in-band">impl <a class="trait" href="../../chrono/trait.Timelike.html" title="trait chrono::Timelike">Timelike</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Timelike" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1020-1186" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.hour" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.hour" class="fnname">hour</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1034-1036" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the hour number from 0 to 23.</p>
|
||||
<p>See also the <a href="./struct.NaiveTime.html#method.hour"><code>NaiveTime::hour</code></a> method.</p>
|
||||
<h1 id="example-33" class="section-header"><a href="#example-33">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">hour</span>(), <span class="number">12</span>);</pre></div>
|
||||
</div><h4 id="method.minute" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.minute" class="fnname">minute</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1051-1053" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the minute number from 0 to 59.</p>
|
||||
<p>See also the <a href="./struct.NaiveTime.html#method.minute"><code>NaiveTime::minute</code></a> method.</p>
|
||||
<h1 id="example-34" class="section-header"><a href="#example-34">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">minute</span>(), <span class="number">34</span>);</pre></div>
|
||||
</div><h4 id="method.second" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.second" class="fnname">second</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1068-1070" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the second number from 0 to 59.</p>
|
||||
<p>See also the <a href="./struct.NaiveTime.html#method.second"><code>NaiveTime::second</code></a> method.</p>
|
||||
<h1 id="example-35" class="section-header"><a href="#example-35">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">second</span>(), <span class="number">56</span>);</pre></div>
|
||||
</div><h4 id="method.nanosecond" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.nanosecond" class="fnname">nanosecond</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1088-1090" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the number of nanoseconds since the whole non-leap second.
|
||||
The range from 1,000,000,000 to 1,999,999,999 represents
|
||||
the <a href="./struct.NaiveTime.html#leap-second-handling">leap second</a>.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveTime.html#method.nanosecond"><code>NaiveTime::nanosecond</code></a> method.</p>
|
||||
<h1 id="example-36" class="section-header"><a href="#example-36">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">nanosecond</span>(), <span class="number">789_000_000</span>);</pre></div>
|
||||
</div><h4 id="method.with_hour" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.with_hour" class="fnname">with_hour</a>(&self, hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1110-1112" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the hour number changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveTime.html#method.with_hour"><code>NaiveTime::with_hour</code></a> method.</p>
|
||||
<h1 id="example-37" class="section-header"><a href="#example-37">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_hour</span>(<span class="number">7</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">7</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_hour</span>(<span class="number">24</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.with_minute" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.with_minute" class="fnname">with_minute</a>(&self, min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1132-1134" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the minute number changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveTime.html#method.with_minute"><code>NaiveTime::with_minute</code></a> method.</p>
|
||||
<h1 id="example-38" class="section-header"><a href="#example-38">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_minute</span>(<span class="number">45</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">45</span>, <span class="number">56</span>, <span class="number">789</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_minute</span>(<span class="number">60</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.with_second" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.with_second" class="fnname">with_second</a>(&self, sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1156-1158" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with the second number changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.
|
||||
As with the <a href="#method.second"><code>second</code></a> method,
|
||||
the input range is restricted to 0 through 59.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveTime.html#method.with_second"><code>NaiveTime::with_second</code></a> method.</p>
|
||||
<h1 id="example-39" class="section-header"><a href="#example-39">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_second</span>(<span class="number">17</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">17</span>, <span class="number">789</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_second</span>(<span class="number">60</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.with_nanosecond" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.with_nanosecond" class="fnname">with_nanosecond</a>(&self, nano: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a>></code><a class="srclink" href="../../src/chrono/naive/datetime.rs.html#1183-1185" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveDateTime</code> with nanoseconds since the whole non-leap second changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveDateTime</code> would be invalid.
|
||||
As with the <a href="#method.nanosecond"><code>nanosecond</code></a> method,
|
||||
the input range can exceed 1,000,000,000 for leap seconds.</p>
|
||||
<p>See also the
|
||||
<a href="./struct.NaiveTime.html#method.with_nanosecond"><code>NaiveTime::with_nanosecond</code></a>
|
||||
method.</p>
|
||||
<h1 id="example-40" class="section-header"><a href="#example-40">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveDateTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span>: <span class="ident">NaiveDateTime</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_milli</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">789</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_nanosecond</span>(<span class="number">333_333_333</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_nano</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">333_333_333</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_nanosecond</span>(<span class="number">1_333_333_333</span>), <span class="comment">// leap second</span>
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">9</span>, <span class="number">8</span>).<span class="ident">and_hms_nano</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>, <span class="number">1_333_333_333</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_nanosecond</span>(<span class="number">2_000_000_000</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.hour12" class="method hidden"><code>fn <a href="../../chrono/trait.Timelike.html#method.hour12" class="fnname">hour12</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code><a class="srclink" href="../../src/chrono/lib.rs.html#1370-1377" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns the hour number from 1 to 12 with a boolean flag,
|
||||
which is false for AM and true for PM. <a href="../../chrono/trait.Timelike.html#method.hour12">Read more</a></p>
|
||||
</div><h4 id="method.num_seconds_from_midnight" class="method hidden"><code>fn <a href="../../chrono/trait.Timelike.html#method.num_seconds_from_midnight" class="fnname">num_seconds_from_midnight</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/lib.rs.html#1416-1418" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns the number of non-leap seconds past the last midnight.</p>
|
||||
</div></div></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><h3 id="impl-RefUnwindSafe" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/std/panic/trait.RefUnwindSafe.html" title="trait std::panic::RefUnwindSafe">RefUnwindSafe</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-RefUnwindSafe" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Send" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Send" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Sync" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Sync" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Unpin" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-Unpin" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-UnwindSafe" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html" title="trait std::panic::UnwindSafe">UnwindSafe</a> for <a class="struct" href="../../chrono/naive/struct.NaiveDateTime.html" title="struct chrono::naive::NaiveDateTime">NaiveDateTime</a></code><a href="#impl-UnwindSafe" class="anchor"></a></h3><div class="impl-items"></div></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><h3 id="impl-Any" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T <span class="where fmt-newline">where<br> T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-Any" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#131-135" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.type_id" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html#tymethod.type_id" class="fnname">type_id</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/nightly/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#132" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html#tymethod.type_id">Read more</a></p>
|
||||
</div></div><h3 id="impl-Borrow%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-Borrow%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#207-211" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.borrow" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html#tymethod.borrow" class="fnname">borrow</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#208" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></p>
|
||||
</div></div><h3 id="impl-BorrowMut%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-BorrowMut%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#214-218" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.borrow_mut" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fnname">borrow_mut</a>(&mut self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#215" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></p>
|
||||
</div></div><h3 id="impl-From%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for T</code><a href="#impl-From%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#545-549" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html#tymethod.from" class="fnname">from</a>(t: T) -> T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#546" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-Into%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html" title="trait core::convert::From">From</a><T>, </span></code><a href="#impl-Into%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#534-541" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html#tymethod.into" class="fnname">into</a>(self) -> U</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#538" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-ToOwned" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>, </span></code><a href="#impl-ToOwned" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#81-93" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Owned" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="type">Owned</a> = T</code></h4><div class='docblock'><p>The resulting type after obtaining ownership.</p>
|
||||
</div><h4 id="method.to_owned" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fnname">to_owned</a>(&self) -> T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#86" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></p>
|
||||
</div><h4 id="method.clone_into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fnname">clone_into</a>(&self, target: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>T)</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#90" title="goto source code">[src]</a></h4><div class="item-info hidden"><div class="stab unstable"><details><summary><span class="emoji">🔬</span> This is a nightly-only experimental API. (<code>toowned_clone_into</code>)</summary><p>recently added</p>
|
||||
</details></div></div><div class='docblock hidden'><p>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></p>
|
||||
</div></div><h3 id="impl-ToString" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html" title="trait alloc::string::ToString">ToString</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-ToString" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/string.rs.html#2205-2218" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.to_string" class="method hidden"><code>pub default fn <a href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html#tymethod.to_string" class="fnname">to_string</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/nightly/alloc/string/struct.String.html" title="struct alloc::string::String">String</a></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/string.rs.html#2211" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Converts the given value to a <code>String</code>. <a href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html#tymethod.to_string">Read more</a></p>
|
||||
</div></div><h3 id="impl-TryFrom%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><T>, </span></code><a href="#impl-TryFrom%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#582-591" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Error" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" class="type">Error</a> = <a class="enum" href="https://doc.rust-lang.org/nightly/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></code></h4><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||||
</div><h4 id="method.try_from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#tymethod.try_from" class="fnname">try_from</a>(value: U) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a><T, <T as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#588" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-TryInto%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>, </span></code><a href="#impl-TryInto%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#568-577" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Error-1" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html#associatedtype.Error" class="type">Error</a> = <U as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></code></h4><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||||
</div><h4 id="method.try_into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html#tymethod.try_into" class="fnname">try_into</a>(self) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a><U, <U as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#574" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div></div></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,780 @@
|
||||
<!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 time without timezone. Allows for the nanosecond precision and optional leap second representation."><meta name="keywords" content="rust, rustlang, rust-lang, NaiveTime"><title>chrono::naive::NaiveTime - Rust</title><link rel="stylesheet" type="text/css" href="../../normalize.css"><link rel="stylesheet" type="text/css" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../light.css" id="themeStyle"><link rel="stylesheet" type="text/css" href="../../dark.css" disabled ><link rel="stylesheet" type="text/css" href="../../ayu.css" disabled ><script id="default-settings"></script><script src="../../storage.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="icon" type="image/svg+xml" href="../../favicon.svg">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-16x16.png">
|
||||
<link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><style type="text/css">#crate-search{background-image:url("../../down-arrow.svg");}</style></head><body class="rustdoc struct"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">☰</div><a href='../../chrono/index.html'><div class='logo-container rust-logo'><img src='../../rust-logo.png' alt='logo'></div></a><p class="location">Struct NaiveTime</p><div class="sidebar-elems"><div class="block items"><a class="sidebar-title" href="#implementations">Methods</a><div class="sidebar-links"><a href="#method.format">format</a><a href="#method.format_with_items">format_with_items</a><a href="#method.from_hms">from_hms</a><a href="#method.from_hms_micro">from_hms_micro</a><a href="#method.from_hms_micro_opt">from_hms_micro_opt</a><a href="#method.from_hms_milli">from_hms_milli</a><a href="#method.from_hms_milli_opt">from_hms_milli_opt</a><a href="#method.from_hms_nano">from_hms_nano</a><a href="#method.from_hms_nano_opt">from_hms_nano_opt</a><a href="#method.from_hms_opt">from_hms_opt</a><a href="#method.from_num_seconds_from_midnight">from_num_seconds_from_midnight</a><a href="#method.from_num_seconds_from_midnight_opt">from_num_seconds_from_midnight_opt</a><a href="#method.overflowing_add_signed">overflowing_add_signed</a><a href="#method.overflowing_sub_signed">overflowing_sub_signed</a><a href="#method.parse_from_str">parse_from_str</a><a href="#method.signed_duration_since">signed_duration_since</a></div><a class="sidebar-title" href="#trait-implementations">Trait Implementations</a><div class="sidebar-links"><a href="#impl-Add%3CDuration%3E">Add<Duration></a><a href="#impl-Add%3CFixedOffset%3E">Add<FixedOffset></a><a href="#impl-AddAssign%3CDuration%3E">AddAssign<Duration></a><a href="#impl-Clone">Clone</a><a href="#impl-Copy">Copy</a><a href="#impl-Debug">Debug</a><a href="#impl-Display">Display</a><a href="#impl-Eq">Eq</a><a href="#impl-FromStr">FromStr</a><a href="#impl-Hash">Hash</a><a href="#impl-Ord">Ord</a><a href="#impl-PartialEq%3CNaiveTime%3E">PartialEq<NaiveTime></a><a href="#impl-PartialOrd%3CNaiveTime%3E">PartialOrd<NaiveTime></a><a href="#impl-StructuralEq">StructuralEq</a><a href="#impl-StructuralPartialEq">StructuralPartialEq</a><a href="#impl-Sub%3CDuration%3E">Sub<Duration></a><a href="#impl-Sub%3CFixedOffset%3E">Sub<FixedOffset></a><a href="#impl-Sub%3CNaiveTime%3E">Sub<NaiveTime></a><a href="#impl-SubAssign%3CDuration%3E">SubAssign<Duration></a><a href="#impl-Timelike">Timelike</a></div><a class="sidebar-title" href="#synthetic-implementations">Auto Trait Implementations</a><div class="sidebar-links"><a href="#impl-RefUnwindSafe">RefUnwindSafe</a><a href="#impl-Send">Send</a><a href="#impl-Sync">Sync</a><a href="#impl-Unpin">Unpin</a><a href="#impl-UnwindSafe">UnwindSafe</a></div><a class="sidebar-title" href="#blanket-implementations">Blanket Implementations</a><div class="sidebar-links"><a href="#impl-Any">Any</a><a href="#impl-Borrow%3CT%3E">Borrow<T></a><a href="#impl-BorrowMut%3CT%3E">BorrowMut<T></a><a href="#impl-From%3CT%3E">From<T></a><a href="#impl-Into%3CU%3E">Into<U></a><a href="#impl-ToOwned">ToOwned</a><a href="#impl-ToString">ToString</a><a href="#impl-TryFrom%3CU%3E">TryFrom<U></a><a href="#impl-TryInto%3CU%3E">TryInto<U></a></div></div><p class="location"><a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a></p><div id="sidebar-vars" data-name="NaiveTime" data-ty="struct" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu"><img src="../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices" role="menu"></div></div><script src="../../theme.js"></script><nav class="sub"><form class="search-form"><div class="search-container"><div><select id="crate-search"><option value="All crates">All crates</option></select><input class="search-input" name="search" disabled autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"></div><button type="button" class="help-button">?</button>
|
||||
<a id="settings-menu" href="../../settings.html"><img src="../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><h1 class="fqn"><span class="in-band">Struct <a href="../index.html">chrono</a>::<wbr><a href="index.html">naive</a>::<wbr><a class="struct" href="">NaiveTime</a></span><span class="out-of-band"><span id="render-detail"><a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span><a class="srclink" href="../../src/chrono/naive/time.rs.html#182-185" title="goto source code">[src]</a></span></h1><div class="docblock type-decl hidden-by-usual-hider"><pre class="rust struct">pub struct NaiveTime { /* fields omitted */ }</pre></div><div class="docblock"><p>ISO 8601 time without timezone.
|
||||
Allows for the nanosecond precision and optional leap second representation.</p>
|
||||
<h1 id="leap-second-handling" class="section-header"><a href="#leap-second-handling">Leap Second Handling</a></h1>
|
||||
<p>Since 1960s, the manmade atomic clock has been so accurate that
|
||||
it is much more accurate than Earth’s own motion.
|
||||
It became desirable to define the civil time in terms of the atomic clock,
|
||||
but that risks the desynchronization of the civil time from Earth.
|
||||
To account for this, the designers of the Coordinated Universal Time (UTC)
|
||||
made that the UTC should be kept within 0.9 seconds of the observed Earth-bound time.
|
||||
When the mean solar day is longer than the ideal (86,400 seconds),
|
||||
the error slowly accumulates and it is necessary to add a <strong>leap second</strong>
|
||||
to slow the UTC down a bit.
|
||||
(We may also remove a second to speed the UTC up a bit, but it never happened.)
|
||||
The leap second, if any, follows 23:59:59 of June 30 or December 31 in the UTC.</p>
|
||||
<p>Fast forward to the 21st century,
|
||||
we have seen 26 leap seconds from January 1972 to December 2015.
|
||||
Yes, 26 seconds. Probably you can read this paragraph within 26 seconds.
|
||||
But those 26 seconds, and possibly more in the future, are never predictable,
|
||||
and whether to add a leap second or not is known only before 6 months.
|
||||
Internet-based clocks (via NTP) do account for known leap seconds,
|
||||
but the system API normally doesn’t (and often can’t, with no network connection)
|
||||
and there is no reliable way to retrieve leap second information.</p>
|
||||
<p>Chrono does not try to accurately implement leap seconds; it is impossible.
|
||||
Rather, <strong>it allows for leap seconds but behaves as if there are <em>no other</em> leap seconds.</strong>
|
||||
Various operations will ignore any possible leap second(s)
|
||||
except when any of the operands were actually leap seconds.</p>
|
||||
<p>If you cannot tolerate this behavior,
|
||||
you must use a separate <code>TimeZone</code> for the International Atomic Time (TAI).
|
||||
TAI is like UTC but has no leap seconds, and thus slightly differs from UTC.
|
||||
Chrono does not yet provide such implementation, but it is planned.</p>
|
||||
<h2 id="representing-leap-seconds" class="section-header"><a href="#representing-leap-seconds">Representing Leap Seconds</a></h2>
|
||||
<p>The leap second is indicated via fractional seconds more than 1 second.
|
||||
This makes possible to treat a leap second as the prior non-leap second
|
||||
if you don’t care about sub-second accuracy.
|
||||
You should use the proper formatting to get the raw leap second.</p>
|
||||
<p>All methods accepting fractional seconds will accept such values.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveDate</span>, <span class="ident">NaiveTime</span>, <span class="ident">Utc</span>, <span class="ident">TimeZone</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt1</span> <span class="op">=</span> <span class="ident">NaiveDate</span>::<span class="ident">from_ymd</span>(<span class="number">2015</span>, <span class="number">7</span>, <span class="number">1</span>).<span class="ident">and_hms_micro</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000_000</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt2</span> <span class="op">=</span> <span class="ident">Utc</span>.<span class="ident">ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_nano</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000_000_000</span>);</pre></div>
|
||||
<p>Note that the leap second can happen anytime given an appropriate time zone;
|
||||
2015-07-01 01:23:60 would be a proper leap second if UTC+01:24 had existed.
|
||||
Practically speaking, though, 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>
|
||||
<h2 id="date-and-time-arithmetics" class="section-header"><a href="#date-and-time-arithmetics">Date And Time Arithmetics</a></h2>
|
||||
<p>As a concrete example, let’s assume that <code>03:00:60</code> and <code>04:00:60</code> are leap seconds.
|
||||
In reality, of course, leap seconds are separated by at least 6 months.
|
||||
We will also use some intuitive concise notations for the explanation.</p>
|
||||
<p><code>Time + Duration</code>
|
||||
(short for <a href="#method.overflowing_add_signed"><code>NaiveTime::overflowing_add_signed</code></a>):</p>
|
||||
<ul>
|
||||
<li><code>03:00:00 + 1s = 03:00:01</code>.</li>
|
||||
<li><code>03:00:59 + 60s = 03:02:00</code>.</li>
|
||||
<li><code>03:00:59 + 1s = 03:01:00</code>.</li>
|
||||
<li><code>03:00:60 + 1s = 03:01:00</code>.
|
||||
Note that the sum is identical to the previous.</li>
|
||||
<li><code>03:00:60 + 60s = 03:01:59</code>.</li>
|
||||
<li><code>03:00:60 + 61s = 03:02:00</code>.</li>
|
||||
<li><code>03:00:60.1 + 0.8s = 03:00:60.9</code>.</li>
|
||||
</ul>
|
||||
<p><code>Time - Duration</code>
|
||||
(short for <a href="#method.overflowing_sub_signed"><code>NaiveTime::overflowing_sub_signed</code></a>):</p>
|
||||
<ul>
|
||||
<li><code>03:00:00 - 1s = 02:59:59</code>.</li>
|
||||
<li><code>03:01:00 - 1s = 03:00:59</code>.</li>
|
||||
<li><code>03:01:00 - 60s = 03:00:00</code>.</li>
|
||||
<li><code>03:00:60 - 60s = 03:00:00</code>.
|
||||
Note that the result is identical to the previous.</li>
|
||||
<li><code>03:00:60.7 - 0.4s = 03:00:60.3</code>.</li>
|
||||
<li><code>03:00:60.7 - 0.9s = 03:00:59.8</code>.</li>
|
||||
</ul>
|
||||
<p><code>Time - Time</code>
|
||||
(short for <a href="#method.signed_duration_since"><code>NaiveTime::signed_duration_since</code></a>):</p>
|
||||
<ul>
|
||||
<li><code>04:00:00 - 03:00:00 = 3600s</code>.</li>
|
||||
<li><code>03:01:00 - 03:00:00 = 60s</code>.</li>
|
||||
<li><code>03:00:60 - 03:00:00 = 60s</code>.
|
||||
Note that the difference is identical to the previous.</li>
|
||||
<li><code>03:00:60.6 - 03:00:59.4 = 1.2s</code>.</li>
|
||||
<li><code>03:01:00 - 03:00:59.8 = 0.2s</code>.</li>
|
||||
<li><code>03:01:00 - 03:00:60.5 = 0.5s</code>.
|
||||
Note that the difference is larger than the previous,
|
||||
even though the leap second clearly follows the previous whole second.</li>
|
||||
<li><code>04:00:60.9 - 03:00:60.1 = (04:00:60.9 - 04:00:00) + (04:00:00 - 03:01:00) + (03:01:00 - 03:00:60.1) = 60.9s + 3540s + 0.9s = 3601.8s</code>.</li>
|
||||
</ul>
|
||||
<p>In general,</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p><code>Time + Duration</code> unconditionally equals to <code>Duration + Time</code>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><code>Time - Duration</code> unconditionally equals to <code>Time + (-Duration)</code>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><code>Time1 - Time2</code> unconditionally equals to <code>-(Time2 - Time1)</code>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Associativity does not generally hold, because
|
||||
<code>(Time + Duration1) - Duration2</code> no longer equals to <code>Time + (Duration1 - Duration2)</code>
|
||||
for two positive durations.</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>As a special case, <code>(Time + Duration) - Duration</code> also does not equal to <code>Time</code>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>If you can assume that all durations have the same sign, however,
|
||||
then the associativity holds:
|
||||
<code>(Time + Duration1) + Duration2</code> equals to <code>Time + (Duration1 + Duration2)</code>
|
||||
for two positive durations.</p>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="reading-and-writing-leap-seconds" class="section-header"><a href="#reading-and-writing-leap-seconds">Reading And Writing Leap Seconds</a></h2>
|
||||
<p>The “typical” leap seconds on the minute boundary are
|
||||
correctly handled both in the formatting and parsing.
|
||||
The leap second in the human-readable representation
|
||||
will be represented as the second part being 60, as required by ISO 8601.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Utc</span>, <span class="ident">TimeZone</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">Utc</span>.<span class="ident">ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">dt</span>), <span class="string">"2015-06-30T23:59:60Z"</span>);</pre></div>
|
||||
<p>There are hypothetical leap seconds not on the minute boundary
|
||||
nevertheless supported by Chrono.
|
||||
They are allowed for the sake of completeness and consistency;
|
||||
there were several “exotic” time zone offsets with fractional minutes prior to UTC after all.
|
||||
For such cases the human-readable representation is ambiguous
|
||||
and would be read back to the next non-leap second.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">DateTime</span>, <span class="ident">Utc</span>, <span class="ident">TimeZone</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">Utc</span>.<span class="ident">ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms_milli</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">1_000</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">dt</span>), <span class="string">"2015-06-30T23:56:05Z"</span>);
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">Utc</span>.<span class="ident">ymd</span>(<span class="number">2015</span>, <span class="number">6</span>, <span class="number">30</span>).<span class="ident">and_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">5</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">dt</span>), <span class="string">"2015-06-30T23:56:05Z"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">DateTime</span>::<span class="ident">parse_from_rfc3339</span>(<span class="string">"2015-06-30T23:56:05Z"</span>).<span class="ident">unwrap</span>(), <span class="ident">dt</span>);</pre></div>
|
||||
<p>Since Chrono alone cannot determine any existence of leap seconds,
|
||||
<strong>there is absolutely no guarantee that the leap second read has actually happened</strong>.</p>
|
||||
</div><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><h3 id="impl" class="impl"><code class="in-band">impl <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#187-801" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.from_hms" class="method"><code>pub fn <a href="#method.from_hms" class="fnname">from_hms</a>(hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#207-209" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from hour, minute and second.</p>
|
||||
<p>No <a href="#leap-second-handling">leap second</a> is allowed here;
|
||||
use <code>NaiveTime::from_hms_*</code> methods with a subsecond parameter instead.</p>
|
||||
<p>Panics on invalid hour, minute and/or second.</p>
|
||||
<h1 id="example" class="section-header"><a href="#example">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">hour</span>(), <span class="number">23</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">minute</span>(), <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">second</span>(), <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">nanosecond</span>(), <span class="number">0</span>);</pre></div>
|
||||
</div><h4 id="method.from_hms_opt" class="method"><code>pub fn <a href="#method.from_hms_opt" class="fnname">from_hms_opt</a>(hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#232-234" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from hour, minute and second.</p>
|
||||
<p>No <a href="#leap-second-handling">leap second</a> is allowed here;
|
||||
use <code>NaiveTime::from_hms_*_opt</code> methods with a subsecond parameter instead.</p>
|
||||
<p>Returns <code>None</code> on invalid hour, minute and/or second.</p>
|
||||
<h1 id="example-1" class="section-header"><a href="#example-1">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hms_opt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_opt</span>;
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hms_opt</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hms_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hms_opt</span>(<span class="number">24</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hms_opt</span>(<span class="number">23</span>, <span class="number">60</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hms_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">60</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.from_hms_milli" class="method"><code>pub fn <a href="#method.from_hms_milli" class="fnname">from_hms_milli</a>(hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, milli: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#255-257" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from hour, minute, second and millisecond.</p>
|
||||
<p>The millisecond part can exceed 1,000
|
||||
in order to represent the <a href="#leap-second-handling">leap second</a>.</p>
|
||||
<p>Panics on invalid hour, minute, second and/or millisecond.</p>
|
||||
<h1 id="example-2" class="section-header"><a href="#example-2">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">hour</span>(), <span class="number">23</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">minute</span>(), <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">second</span>(), <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">nanosecond</span>(), <span class="number">12_000_000</span>);</pre></div>
|
||||
</div><h4 id="method.from_hms_milli_opt" class="method"><code>pub fn <a href="#method.from_hms_milli_opt" class="fnname">from_hms_milli_opt</a>(<br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> milli: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#282-286" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from hour, minute, second and millisecond.</p>
|
||||
<p>The millisecond part can exceed 1,000
|
||||
in order to represent the <a href="#leap-second-handling">leap second</a>.</p>
|
||||
<p>Returns <code>None</code> on invalid hour, minute, second and/or millisecond.</p>
|
||||
<h1 id="example-3" class="section-header"><a href="#example-3">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hmsm_opt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli_opt</span>;
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsm_opt</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsm_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">999</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsm_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_999</span>).<span class="ident">is_some</span>()); <span class="comment">// a leap second after 23:59:59</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsm_opt</span>(<span class="number">24</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsm_opt</span>(<span class="number">23</span>, <span class="number">60</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsm_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">60</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsm_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">2_000</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.from_hms_micro" class="method"><code>pub fn <a href="#method.from_hms_micro" class="fnname">from_hms_micro</a>(hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, micro: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#307-309" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from hour, minute, second and microsecond.</p>
|
||||
<p>The microsecond part can exceed 1,000,000
|
||||
in order to represent the <a href="#leap-second-handling">leap second</a>.</p>
|
||||
<p>Panics on invalid hour, minute, second and/or microsecond.</p>
|
||||
<h1 id="example-4" class="section-header"><a href="#example-4">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_micro</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">hour</span>(), <span class="number">23</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">minute</span>(), <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">second</span>(), <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">nanosecond</span>(), <span class="number">12_345_000</span>);</pre></div>
|
||||
</div><h4 id="method.from_hms_micro_opt" class="method"><code>pub fn <a href="#method.from_hms_micro_opt" class="fnname">from_hms_micro_opt</a>(<br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> micro: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#334-336" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from hour, minute, second and microsecond.</p>
|
||||
<p>The microsecond part can exceed 1,000,000
|
||||
in order to represent the <a href="#leap-second-handling">leap second</a>.</p>
|
||||
<p>Returns <code>None</code> on invalid hour, minute, second and/or microsecond.</p>
|
||||
<h1 id="example-5" class="section-header"><a href="#example-5">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hmsu_opt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_micro_opt</span>;
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsu_opt</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsu_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">999_999</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsu_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_999_999</span>).<span class="ident">is_some</span>()); <span class="comment">// a leap second after 23:59:59</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsu_opt</span>(<span class="number">24</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsu_opt</span>(<span class="number">23</span>, <span class="number">60</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsu_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">60</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsu_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">2_000_000</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.from_hms_nano" class="method"><code>pub fn <a href="#method.from_hms_nano" class="fnname">from_hms_nano</a>(hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, nano: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#357-359" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from hour, minute, second and nanosecond.</p>
|
||||
<p>The nanosecond part can exceed 1,000,000,000
|
||||
in order to represent the <a href="#leap-second-handling">leap second</a>.</p>
|
||||
<p>Panics on invalid hour, minute, second and/or nanosecond.</p>
|
||||
<h1 id="example-6" class="section-header"><a href="#example-6">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">hour</span>(), <span class="number">23</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">minute</span>(), <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">second</span>(), <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">nanosecond</span>(), <span class="number">12_345_678</span>);</pre></div>
|
||||
</div><h4 id="method.from_hms_nano_opt" class="method"><code>pub fn <a href="#method.from_hms_nano_opt" class="fnname">from_hms_nano_opt</a>(<br> hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> nano: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#384-390" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from hour, minute, second and nanosecond.</p>
|
||||
<p>The nanosecond part can exceed 1,000,000,000
|
||||
in order to represent the <a href="#leap-second-handling">leap second</a>.</p>
|
||||
<p>Returns <code>None</code> on invalid hour, minute, second and/or nanosecond.</p>
|
||||
<h1 id="example-7" class="section-header"><a href="#example-7">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hmsn_opt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano_opt</span>;
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsn_opt</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsn_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">999_999_999</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsn_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_999_999_999</span>).<span class="ident">is_some</span>()); <span class="comment">// a leap second after 23:59:59</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsn_opt</span>(<span class="number">24</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsn_opt</span>(<span class="number">23</span>, <span class="number">60</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsn_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">60</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_hmsn_opt</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">2_000_000_000</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.from_num_seconds_from_midnight" class="method"><code>pub fn <a href="#method.from_num_seconds_from_midnight" class="fnname">from_num_seconds_from_midnight</a>(secs: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, nano: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#411-413" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from the number of seconds since midnight and nanosecond.</p>
|
||||
<p>The nanosecond part can exceed 1,000,000,000
|
||||
in order to represent the <a href="#leap-second-handling">leap second</a>.</p>
|
||||
<p>Panics on invalid number of seconds and/or nanosecond.</p>
|
||||
<h1 id="example-8" class="section-header"><a href="#example-8">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_num_seconds_from_midnight</span>(<span class="number">86164</span>, <span class="number">12_345_678</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">hour</span>(), <span class="number">23</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">minute</span>(), <span class="number">56</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">second</span>(), <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">nanosecond</span>(), <span class="number">12_345_678</span>);</pre></div>
|
||||
</div><h4 id="method.from_num_seconds_from_midnight_opt" class="method"><code>pub fn <a href="#method.from_num_seconds_from_midnight_opt" class="fnname">from_num_seconds_from_midnight_opt</a>(<br> secs: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br> nano: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#436-441" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> from the number of seconds since midnight and nanosecond.</p>
|
||||
<p>The nanosecond part can exceed 1,000,000,000
|
||||
in order to represent the <a href="#leap-second-handling">leap second</a>.</p>
|
||||
<p>Returns <code>None</code> on invalid number of seconds and/or nanosecond.</p>
|
||||
<h1 id="example-9" class="section-header"><a href="#example-9">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_nsecs_opt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_num_seconds_from_midnight_opt</span>;
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_nsecs_opt</span>(<span class="number">0</span>, <span class="number">0</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_nsecs_opt</span>(<span class="number">86399</span>, <span class="number">999_999_999</span>).<span class="ident">is_some</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_nsecs_opt</span>(<span class="number">86399</span>, <span class="number">1_999_999_999</span>).<span class="ident">is_some</span>()); <span class="comment">// a leap second after 23:59:59</span>
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_nsecs_opt</span>(<span class="number">86_400</span>, <span class="number">0</span>).<span class="ident">is_none</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">from_nsecs_opt</span>(<span class="number">86399</span>, <span class="number">2_000_000_000</span>).<span class="ident">is_none</span>());</pre></div>
|
||||
</div><h4 id="method.parse_from_str" class="method"><code>pub fn <a href="#method.parse_from_str" class="fnname">parse_from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>, fmt: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="type" href="../../chrono/format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#504-508" title="goto source code">[src]</a></h4><div class="docblock"><p>Parses a string with the specified format string and returns a new <code>NaiveTime</code>.
|
||||
See the <a href="../format/strftime/index.html"><code>format::strftime</code> module</a>
|
||||
on the supported escape sequences.</p>
|
||||
<h1 id="example-10" class="section-header"><a href="#example-10">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">parse_from_str</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">parse_from_str</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"23:56:04"</span>, <span class="string">"%H:%M:%S"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"pm012345.6789"</span>, <span class="string">"%p%I%M%S%.f"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_micro</span>(<span class="number">13</span>, <span class="number">23</span>, <span class="number">45</span>, <span class="number">678_900</span>)));</pre></div>
|
||||
<p>Date and offset is ignored for the purpose of parsing.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"2014-5-17T12:34:56+09:30"</span>, <span class="string">"%Y-%m-%dT%H:%M:%S%z"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">12</span>, <span class="number">34</span>, <span class="number">56</span>)));</pre></div>
|
||||
<p><a href="#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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"08:59:60.123"</span>, <span class="string">"%H:%M:%S%.f"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">8</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_123</span>)));</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"7:15"</span>, <span class="string">"%H:%M"</span>),
|
||||
<span class="prelude-val">Ok</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">7</span>, <span class="number">15</span>, <span class="number">0</span>)));
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"04m33s"</span>, <span class="string">"%Mm%Ss"</span>).<span class="ident">is_err</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"12"</span>, <span class="string">"%H"</span>).<span class="ident">is_err</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"17:60"</span>, <span class="string">"%H:%M"</span>).<span class="ident">is_err</span>());
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"24:00:00"</span>, <span class="string">"%H:%M:%S"</span>).<span class="ident">is_err</span>());</pre></div>
|
||||
<p>All parsed fields should be consistent to each other, otherwise it’s an error.
|
||||
Here <code>%H</code> is for 24-hour clocks, unlike <code>%I</code>,
|
||||
and thus can be independently determined without AM/PM.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">parse_from_str</span>(<span class="string">"13:07 AM"</span>, <span class="string">"%H:%M %p"</span>).<span class="ident">is_err</span>());</pre></div>
|
||||
</div><h4 id="method.overflowing_add_signed" class="method"><code>pub fn <a href="#method.overflowing_add_signed" class="fnname">overflowing_add_signed</a>(&self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#532-593" title="goto source code">[src]</a></h4><div class="docblock"><p>Adds given <code>Duration</code> to the current time,
|
||||
and also returns the number of <em>seconds</em>
|
||||
in the integral number of days ignored from the addition.
|
||||
(We cannot return <code>Duration</code> because it is subject to overflow or underflow.)</p>
|
||||
<h1 id="example-11" class="section-header"><a href="#example-11">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hms</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hms</span>(<span class="number">3</span>, <span class="number">4</span>, <span class="number">5</span>).<span class="ident">overflowing_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">hours</span>(<span class="number">11</span>)),
|
||||
(<span class="ident">from_hms</span>(<span class="number">14</span>, <span class="number">4</span>, <span class="number">5</span>), <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hms</span>(<span class="number">3</span>, <span class="number">4</span>, <span class="number">5</span>).<span class="ident">overflowing_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">hours</span>(<span class="number">23</span>)),
|
||||
(<span class="ident">from_hms</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">5</span>), <span class="number">86_400</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hms</span>(<span class="number">3</span>, <span class="number">4</span>, <span class="number">5</span>).<span class="ident">overflowing_add_signed</span>(<span class="ident">Duration</span>::<span class="ident">hours</span>(<span class="op">-</span><span class="number">7</span>)),
|
||||
(<span class="ident">from_hms</span>(<span class="number">20</span>, <span class="number">4</span>, <span class="number">5</span>), <span class="op">-</span><span class="number">86_400</span>));</pre></div>
|
||||
</div><h4 id="method.overflowing_sub_signed" class="method"><code>pub fn <a href="#method.overflowing_sub_signed" class="fnname">overflowing_sub_signed</a>(&self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#617-620" title="goto source code">[src]</a></h4><div class="docblock"><p>Subtracts given <code>Duration</code> from the current time,
|
||||
and also returns the number of <em>seconds</em>
|
||||
in the integral number of days ignored from the subtraction.
|
||||
(We cannot return <code>Duration</code> because it is subject to overflow or underflow.)</p>
|
||||
<h1 id="example-12" class="section-header"><a href="#example-12">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hms</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hms</span>(<span class="number">3</span>, <span class="number">4</span>, <span class="number">5</span>).<span class="ident">overflowing_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">hours</span>(<span class="number">2</span>)),
|
||||
(<span class="ident">from_hms</span>(<span class="number">1</span>, <span class="number">4</span>, <span class="number">5</span>), <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hms</span>(<span class="number">3</span>, <span class="number">4</span>, <span class="number">5</span>).<span class="ident">overflowing_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">hours</span>(<span class="number">17</span>)),
|
||||
(<span class="ident">from_hms</span>(<span class="number">10</span>, <span class="number">4</span>, <span class="number">5</span>), <span class="number">86_400</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hms</span>(<span class="number">3</span>, <span class="number">4</span>, <span class="number">5</span>).<span class="ident">overflowing_sub_signed</span>(<span class="ident">Duration</span>::<span class="ident">hours</span>(<span class="op">-</span><span class="number">22</span>)),
|
||||
(<span class="ident">from_hms</span>(<span class="number">1</span>, <span class="number">4</span>, <span class="number">5</span>), <span class="op">-</span><span class="number">86_400</span>));</pre></div>
|
||||
</div><h4 id="method.signed_duration_since" class="method"><code>pub fn <a href="#method.signed_duration_since" class="fnname">signed_duration_since</a>(self, rhs: <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#680-716" title="goto source code">[src]</a></h4><div class="docblock"><p>Subtracts another <code>NaiveTime</code> from the current time.
|
||||
Returns a <code>Duration</code> within +/- 1 day.
|
||||
This does not overflow or underflow at all.</p>
|
||||
<p>As a part of Chrono’s <a href="#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>NaiveTime</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>
|
||||
<h1 id="example-13" class="section-header"><a href="#example-13">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hmsm</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>;
|
||||
<span class="kw">let</span> <span class="ident">since</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">signed_duration_since</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">zero</span>());
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">875</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">25</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">925</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">975</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">0</span>, <span class="number">900</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">7</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">7</span>, <span class="number">900</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">5</span> <span class="op">*</span> <span class="number">60</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">from_hmsm</span>(<span class="number">0</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3</span> <span class="op">*</span> <span class="number">3600</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">from_hmsm</span>(<span class="number">4</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">3600</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">from_hmsm</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">6</span>, <span class="number">800</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span> <span class="op">+</span> <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">100</span>));</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">1_000</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">0</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">1_500</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">0</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">1500</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">1_000</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">60</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>), <span class="ident">from_hmsm</span>(<span class="number">2</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">since</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">1_000</span>), <span class="ident">from_hmsm</span>(<span class="number">2</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>)),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">61</span>));</pre></div>
|
||||
</div><h4 id="method.format_with_items" class="method"><code>pub fn <a href="#method.format_with_items" class="fnname">format_with_items</a><'a, I, B>(&self, items: I) -> <a class="struct" href="../../chrono/format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><I> <span class="where fmt-newline">where<br> I: <a class="trait" href="https://doc.rust-lang.org/nightly/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/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,<br> B: <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><<a class="enum" href="../../chrono/format/enum.Item.html" title="enum chrono::format::Item">Item</a><'a>>, </span></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#747-753" title="goto source code">[src]</a></h4><div class="docblock"><p>Formats the 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>
|
||||
<h1 id="example-14" class="section-header"><a href="#example-14">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">format</span>::<span class="ident">strftime</span>::<span class="ident">StrftimeItems</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">fmt</span> <span class="op">=</span> <span class="ident">StrftimeItems</span>::<span class="ident">new</span>(<span class="string">"%H:%M:%S"</span>);
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>.<span class="ident">clone</span>()).<span class="ident">to_string</span>(), <span class="string">"23:56:04"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">format</span>(<span class="string">"%H:%M:%S"</span>).<span class="ident">to_string</span>(), <span class="string">"23:56:04"</span>);</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">t</span>.<span class="ident">format_with_items</span>(<span class="ident">fmt</span>)), <span class="string">"23:56:04"</span>);</pre></div>
|
||||
</div><h4 id="method.format" class="method"><code>pub fn <a href="#method.format" class="fnname">format</a><'a>(&self, fmt: &'a <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="struct" href="../../chrono/format/struct.DelayedFormat.html" title="struct chrono::format::DelayedFormat">DelayedFormat</a><<a class="struct" href="../../chrono/format/strftime/struct.StrftimeItems.html" title="struct chrono::format::strftime::StrftimeItems">StrftimeItems</a><'a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#791-793" title="goto source code">[src]</a></h4><div class="docblock"><p>Formats the 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>
|
||||
<h1 id="example-15" class="section-header"><a href="#example-15">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">format</span>(<span class="string">"%H:%M:%S"</span>).<span class="ident">to_string</span>(), <span class="string">"23:56:04"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">format</span>(<span class="string">"%H:%M:%S%.6f"</span>).<span class="ident">to_string</span>(), <span class="string">"23:56:04.012345"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">t</span>.<span class="ident">format</span>(<span class="string">"%-I:%M %p"</span>).<span class="ident">to_string</span>(), <span class="string">"11:56 PM"</span>);</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">t</span>.<span class="ident">format</span>(<span class="string">"%H:%M:%S"</span>)), <span class="string">"23:56:04"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">t</span>.<span class="ident">format</span>(<span class="string">"%H:%M:%S%.6f"</span>)), <span class="string">"23:56:04.012345"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">t</span>.<span class="ident">format</span>(<span class="string">"%-I:%M %p"</span>)), <span class="string">"11:56 PM"</span>);</pre></div>
|
||||
</div></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><h3 id="impl-Add%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Add%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1078-1085" title="goto source code">[src]</a></h3><div class="docblock"><p>An addition of <code>Duration</code> to <code>NaiveTime</code> wraps around and never overflows or underflows.
|
||||
In particular the addition ignores integral number of days.</p>
|
||||
<p>As a part of Chrono’s <a href="#leap-second-handling">leap second handling</a>,
|
||||
the addition assumes that <strong>there is no leap second ever</strong>,
|
||||
except when the <code>NaiveTime</code> itself represents a leap second
|
||||
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
|
||||
<h1 id="example-29" class="section-header"><a href="#example-29">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hmsm</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">1</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">60</span> <span class="op">+</span> <span class="number">4</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">11</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">7</span><span class="kw-2">*</span><span class="number">60</span><span class="kw-2">*</span><span class="number">60</span> <span class="op">-</span> <span class="number">6</span><span class="kw-2">*</span><span class="number">60</span>), <span class="ident">from_hmsm</span>(<span class="number">9</span>, <span class="number">59</span>, <span class="number">7</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">80</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">80</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">950</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">280</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">8</span>, <span class="number">230</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">950</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="op">-</span><span class="number">980</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">970</span>));</pre></div>
|
||||
<p>The addition wraps around.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">22</span><span class="kw-2">*</span><span class="number">60</span><span class="kw-2">*</span><span class="number">60</span>), <span class="ident">from_hmsm</span>(<span class="number">1</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">8</span><span class="kw-2">*</span><span class="number">60</span><span class="kw-2">*</span><span class="number">60</span>), <span class="ident">from_hmsm</span>(<span class="number">19</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">800</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>));</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">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="op">-</span><span class="number">500</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_800</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">800</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">100</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">10</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">9</span>, <span class="number">300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">10</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">50</span>, <span class="number">300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">300</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output-4" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>+</code> operator.</p>
|
||||
</div><h4 id="method.add-1" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add" class="fnname">add</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1082-1084" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></p>
|
||||
</div></div><h3 id="impl-Add%3CFixedOffset%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html" title="trait core::ops::arith::Add">Add</a><<a class="struct" href="../../chrono/offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Add%3CFixedOffset%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#164-171" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Output-3" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>+</code> operator.</p>
|
||||
</div><h4 id="method.add" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add" class="fnname">add</a>(self, rhs: <a class="struct" href="../../chrono/offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#168-170" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>+</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Add.html#tymethod.add">Read more</a></p>
|
||||
</div></div><h3 id="impl-AddAssign%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html" title="trait core::ops::arith::AddAssign">AddAssign</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-AddAssign%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1087-1092" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.add_assign" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html#tymethod.add_assign" class="fnname">add_assign</a>(&mut self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1089-1091" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>+=</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.AddAssign.html#tymethod.add_assign">Read more</a></p>
|
||||
</div></div><h3 id="impl-Clone" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Clone" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.clone" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone" class="fnname">clone</a>(&self) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns a copy of the value. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#tymethod.clone">Read more</a></p>
|
||||
</div><h4 id="method.clone_from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from" class="fnname">clone_from</a>(&mut self, source: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Self)</code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/clone.rs.html#128" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html#method.clone_from">Read more</a></p>
|
||||
</div></div><h3 id="impl-Copy" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Copy.html" title="trait core::marker::Copy">Copy</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Copy" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-Debug" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Debug" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1247-1267" title="goto source code">[src]</a></h3><div class="docblock"><p>The <code>Debug</code> output of the naive time <code>t</code> is the same as
|
||||
<a href="../format/strftime/index.html"><code>t.format("%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>
|
||||
<h1 id="example-25" class="section-header"><a href="#example-25">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>)), <span class="string">"23:56:04"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12</span>)), <span class="string">"23:56:04.012"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms_micro</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">1234</span>)), <span class="string">"23:56:04.001234"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">123456</span>)), <span class="string">"23:56:04.000123456"</span>);</pre></div>
|
||||
<p>Leap seconds may also be used.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{:?}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">6</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>)), <span class="string">"06:59:60.500"</span>);</pre></div>
|
||||
</div><div class="impl-items"><h4 id="method.fmt" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/nightly/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1248-1266" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></p>
|
||||
</div></div><h3 id="impl-Display" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Display" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1297-1301" title="goto source code">[src]</a></h3><div class="docblock"><p>The <code>Display</code> output of the naive time <code>t</code> is the same as
|
||||
<a href="../format/strftime/index.html"><code>t.format("%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>
|
||||
<h1 id="example-26" class="section-header"><a href="#example-26">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>)), <span class="string">"23:56:04"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12</span>)), <span class="string">"23:56:04.012"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms_micro</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">1234</span>)), <span class="string">"23:56:04.001234"</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">123456</span>)), <span class="string">"23:56:04.000123456"</span>);</pre></div>
|
||||
<p>Leap seconds may also be used.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">"{}"</span>, <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">6</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_500</span>)), <span class="string">"06:59:60.500"</span>);</pre></div>
|
||||
</div><div class="impl-items"><h4 id="method.fmt-1" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html#tymethod.fmt" class="fnname">fmt</a>(&self, f: &mut <a class="struct" href="https://doc.rust-lang.org/nightly/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a><'_>) -> <a class="type" href="https://doc.rust-lang.org/nightly/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1298-1300" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html#tymethod.fmt">Read more</a></p>
|
||||
</div></div><h3 id="impl-Eq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.Eq.html" title="trait core::cmp::Eq">Eq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Eq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-FromStr" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html" title="trait core::str::traits::FromStr">FromStr</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-FromStr" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1322-1342" title="goto source code">[src]</a></h3><div class="docblock"><p>Parsing a <code>str</code> into a <code>NaiveTime</code> uses the same format,
|
||||
<a href="../format/strftime/index.html"><code>%H:%M:%S%.f</code></a>, as in <code>Debug</code> and <code>Display</code>.</p>
|
||||
<h1 id="example-30" class="section-header"><a href="#example-30">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::<span class="ident">NaiveTime</span>;
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="string">"23:56:04"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveTime</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">t</span>));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="string">"23:56:4.012345678"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveTime</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">t</span>));
|
||||
|
||||
<span class="kw">let</span> <span class="ident">t</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_234_567_890</span>); <span class="comment">// leap second</span>
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="string">"23:59:60.23456789"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveTime</span><span class="op">></span>(), <span class="prelude-val">Ok</span>(<span class="ident">t</span>));
|
||||
|
||||
<span class="macro">assert</span><span class="macro">!</span>(<span class="string">"foo"</span>.<span class="ident">parse</span>::<span class="op"><</span><span class="ident">NaiveTime</span><span class="op">></span>().<span class="ident">is_err</span>());</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Err" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#associatedtype.Err" class="type">Err</a> = <a class="struct" href="../../chrono/format/struct.ParseError.html" title="struct chrono::format::ParseError">ParseError</a></code></h4><div class='docblock'><p>The associated error which can be returned from parsing.</p>
|
||||
</div><h4 id="method.from_str" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#tymethod.from_str" class="fnname">from_str</a>(s: &<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -> <a class="type" href="../../chrono/format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1325-1341" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Parses a string <code>s</code> to return a value of this type. <a href="https://doc.rust-lang.org/nightly/core/str/traits/trait.FromStr.html#tymethod.from_str">Read more</a></p>
|
||||
</div></div><h3 id="impl-Hash" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html" title="trait core::hash::Hash">Hash</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Hash" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1016-1021" title="goto source code">[src]</a></h3><div class="docblock"><p><code>NaiveTime</code> can be used as a key to the hash maps (in principle).</p>
|
||||
<p>Practically this also takes account of fractional seconds, so it is not recommended.
|
||||
(For the obvious reason this also distinguishes leap seconds from non-leap seconds.)</p>
|
||||
</div><div class="impl-items"><h4 id="method.hash" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#tymethod.hash" class="fnname">hash</a><H: <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>>(&self, state: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>H)</code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1017-1020" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Feeds this value into the given <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#tymethod.hash">Read more</a></p>
|
||||
</div><h4 id="method.hash_slice" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#method.hash_slice" class="fnname">hash_slice</a><H>(data: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.slice.html">&[Self]</a>, state: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>H) <span class="where fmt-newline">where<br> H: <a class="trait" href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="trait core::hash::Hasher">Hasher</a>, </span></code><span class="since" title="Stable since Rust version 1.3.0">1.3.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/hash/mod.rs.html#184-186" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Feeds a slice of this type into the given <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hasher.html" title="Hasher"><code>Hasher</code></a>. <a href="https://doc.rust-lang.org/nightly/core/hash/trait.Hash.html#method.hash_slice">Read more</a></p>
|
||||
</div></div><h3 id="impl-Ord" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html" title="trait core::cmp::Ord">Ord</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Ord" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.cmp" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#tymethod.cmp" class="fnname">cmp</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method returns an <a href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="Ordering"><code>Ordering</code></a> between <code>self</code> and <code>other</code>. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#tymethod.cmp">Read more</a></p>
|
||||
</div><h4 id="method.max" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.max" class="fnname">max</a>(self, other: Self) -> Self</code><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#723-725" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Compares and returns the maximum of two values. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.max">Read more</a></p>
|
||||
</div><h4 id="method.min" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.min" class="fnname">min</a>(self, other: Self) -> Self</code><span class="since" title="Stable since Rust version 1.21.0">1.21.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#743-745" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Compares and returns the minimum of two values. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.min">Read more</a></p>
|
||||
</div><h4 id="method.clamp" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.clamp" class="fnname">clamp</a>(self, min: Self, max: Self) -> Self</code><span class="since" title="Stable since Rust version 1.50.0">1.50.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#768-770" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Restrict a value to a certain interval. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.Ord.html#method.clamp">Read more</a></p>
|
||||
</div></div><h3 id="impl-PartialEq%3CNaiveTime%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html" title="trait core::cmp::PartialEq">PartialEq</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-PartialEq%3CNaiveTime%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.eq" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#tymethod.eq" class="fnname">eq</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests for <code>self</code> and <code>other</code> values to be equal, and is used
|
||||
by <code>==</code>. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#tymethod.eq">Read more</a></p>
|
||||
</div><h4 id="method.ne" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialEq.html#method.ne" class="fnname">ne</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests for <code>!=</code>.</p>
|
||||
</div></div><h3 id="impl-PartialOrd%3CNaiveTime%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html" title="trait core::cmp::PartialOrd">PartialOrd</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-PartialOrd%3CNaiveTime%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.partial_cmp" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp" class="fnname">partial_cmp</a>(&self, other: &<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="enum" href="https://doc.rust-lang.org/nightly/core/cmp/enum.Ordering.html" title="enum core::cmp::Ordering">Ordering</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method returns an ordering between <code>self</code> and <code>other</code> values if one exists. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#tymethod.partial_cmp">Read more</a></p>
|
||||
</div><h4 id="method.lt" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.lt" class="fnname">lt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#963" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests less than (for <code>self</code> and <code>other</code>) and is used by the <code><</code> operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.lt">Read more</a></p>
|
||||
</div><h4 id="method.le" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.le" class="fnname">le</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#982" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests less than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code><=</code>
|
||||
operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.le">Read more</a></p>
|
||||
</div><h4 id="method.gt" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.gt" class="fnname">gt</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#1000" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests greater than (for <code>self</code> and <code>other</code>) and is used by the <code>></code> operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.gt">Read more</a></p>
|
||||
</div><h4 id="method.ge" class="method hidden"><code><span class="docblock attributes">#[must_use]</span>pub fn <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.ge" class="fnname">ge</a>(&self, other: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>Rhs) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a></code><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/cmp.rs.html#1019" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>This method tests greater than or equal to (for <code>self</code> and <code>other</code>) and is used by the <code>>=</code>
|
||||
operator. <a href="https://doc.rust-lang.org/nightly/core/cmp/trait.PartialOrd.html#method.ge">Read more</a></p>
|
||||
</div></div><h3 id="impl-StructuralEq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.StructuralEq.html" title="trait core::marker::StructuralEq">StructuralEq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-StructuralEq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-StructuralPartialEq" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.StructuralPartialEq.html" title="trait core::marker::StructuralPartialEq">StructuralPartialEq</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-StructuralPartialEq" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#181" title="goto source code">[src]</a></h3><div class="impl-items"></div><h3 id="impl-Sub%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Sub%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1145-1152" title="goto source code">[src]</a></h3><div class="docblock"><p>A subtraction of <code>Duration</code> from <code>NaiveTime</code> wraps around and never overflows or underflows.
|
||||
In particular the addition ignores integral number of days.
|
||||
It is the same as the addition with a negated <code>Duration</code>.</p>
|
||||
<p>As a part of Chrono’s <a href="#leap-second-handling">leap second handling</a>,
|
||||
the addition assumes that <strong>there is no leap second ever</strong>,
|
||||
except when the <code>NaiveTime</code> itself represents a leap second
|
||||
in which case the assumption becomes that <strong>there is exactly a single leap second ever</strong>.</p>
|
||||
<h1 id="example-27" class="section-header"><a href="#example-27">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hmsm</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">60</span> <span class="op">+</span> <span class="number">5</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">4</span>, <span class="number">2</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">2</span><span class="kw-2">*</span><span class="number">60</span><span class="kw-2">*</span><span class="number">60</span> <span class="op">+</span> <span class="number">6</span><span class="kw-2">*</span><span class="number">60</span>), <span class="ident">from_hmsm</span>(<span class="number">0</span>, <span class="number">59</span>, <span class="number">7</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">80</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">920</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">950</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">280</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">670</span>));</pre></div>
|
||||
<p>The subtraction wraps around.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">8</span><span class="kw-2">*</span><span class="number">60</span><span class="kw-2">*</span><span class="number">60</span>), <span class="ident">from_hmsm</span>(<span class="number">19</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">800</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">0</span>));</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">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">zero</span>(), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">200</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">1_100</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">500</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">59</span>, <span class="number">800</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">60</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">0</span>, <span class="number">300</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span> <span class="op">-</span> <span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>), <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">6</span>, <span class="number">0</span>, <span class="number">300</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output-1" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||||
</div><h4 id="method.sub-1" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">sub</a>(self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1149-1151" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||||
</div></div><h3 id="impl-Sub%3CFixedOffset%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../../chrono/offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Sub%3CFixedOffset%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#173-180" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Output" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||||
</div><h4 id="method.sub" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">sub</a>(self, rhs: <a class="struct" href="../../chrono/offset/struct.FixedOffset.html" title="struct chrono::offset::FixedOffset">FixedOffset</a>) -> <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a class="srclink" href="../../src/chrono/offset/fixed.rs.html#177-179" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||||
</div></div><h3 id="impl-Sub%3CNaiveTime%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html" title="trait core::ops::arith::Sub">Sub</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Sub%3CNaiveTime%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1210-1217" title="goto source code">[src]</a></h3><div class="docblock"><p>Subtracts another <code>NaiveTime</code> from the current time.
|
||||
Returns a <code>Duration</code> within +/- 1 day.
|
||||
This does not overflow or underflow at all.</p>
|
||||
<p>As a part of Chrono’s <a href="#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>NaiveTime</code>s themselves represents a leap second
|
||||
in which case the assumption becomes that
|
||||
<strong>there are exactly one (or two) leap second(s) ever</strong>.</p>
|
||||
<p>The implementation is a wrapper around
|
||||
<a href="#method.signed_duration_since"><code>NaiveTime::signed_duration_since</code></a>.</p>
|
||||
<h1 id="example-28" class="section-header"><a href="#example-28">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">Duration</span>, <span class="ident">NaiveTime</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">from_hmsm</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>;
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">Duration</span>::<span class="ident">zero</span>());
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">875</span>), <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">25</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">6</span>, <span class="number">925</span>), <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">975</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">0</span>, <span class="number">900</span>), <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">7</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">5</span> <span class="op">*</span> <span class="number">60</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">0</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3</span> <span class="op">*</span> <span class="number">3600</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">4</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>), <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="op">-</span><span class="number">3600</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">5</span>, <span class="number">7</span>, <span class="number">900</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">2</span>, <span class="number">4</span>, <span class="number">6</span>, <span class="number">800</span>),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">3600</span> <span class="op">+</span> <span class="number">60</span> <span class="op">+</span> <span class="number">1</span>) <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">100</span>));</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">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">1_000</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">0</span>), <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">1_500</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">0</span>),
|
||||
<span class="ident">Duration</span>::<span class="ident">milliseconds</span>(<span class="number">1500</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">1_000</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>), <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">60</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">2</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>), <span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">1</span>));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">from_hmsm</span>(<span class="number">3</span>, <span class="number">0</span>, <span class="number">59</span>, <span class="number">1_000</span>) <span class="op">-</span> <span class="ident">from_hmsm</span>(<span class="number">2</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>),
|
||||
<span class="ident">Duration</span>::<span class="ident">seconds</span>(<span class="number">61</span>));</pre></div>
|
||||
</div><div class="impl-items"><h4 id="associatedtype.Output-2" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#associatedtype.Output" class="type">Output</a> = <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code></h4><div class='docblock'><p>The resulting type after applying the <code>-</code> operator.</p>
|
||||
</div><h4 id="method.sub-2" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub" class="fnname">sub</a>(self, rhs: <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>) -> <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1214-1216" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.Sub.html#tymethod.sub">Read more</a></p>
|
||||
</div></div><h3 id="impl-SubAssign%3CDuration%3E" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html" title="trait core::ops::arith::SubAssign">SubAssign</a><<a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">Duration</a>> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-SubAssign%3CDuration%3E" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#1154-1159" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.sub_assign" class="method hidden"><code>fn <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign" class="fnname">sub_assign</a>(&mut self, rhs: <a class="struct" href="../../chrono/struct.Duration.html" title="struct chrono::Duration">OldDuration</a>)</code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1156-1158" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the <code>-=</code> operation. <a href="https://doc.rust-lang.org/nightly/core/ops/arith/trait.SubAssign.html#tymethod.sub_assign">Read more</a></p>
|
||||
</div></div><h3 id="impl-Timelike" class="impl"><code class="in-band">impl <a class="trait" href="../../chrono/trait.Timelike.html" title="trait chrono::Timelike">Timelike</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Timelike" class="anchor"></a><a class="srclink" href="../../src/chrono/naive/time.rs.html#803-1010" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.hour" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.hour" class="fnname">hour</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#815-817" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the hour number from 0 to 23.</p>
|
||||
<h1 id="example-16" class="section-header"><a href="#example-16">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">hour</span>(), <span class="number">0</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>).<span class="ident">hour</span>(), <span class="number">23</span>);</pre></div>
|
||||
</div><h4 id="method.minute" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.minute" class="fnname">minute</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#830-832" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the minute number from 0 to 59.</p>
|
||||
<h1 id="example-17" class="section-header"><a href="#example-17">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">minute</span>(), <span class="number">0</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>).<span class="ident">minute</span>(), <span class="number">56</span>);</pre></div>
|
||||
</div><h4 id="method.second" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.second" class="fnname">second</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#856-858" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the second number from 0 to 59.</p>
|
||||
<h1 id="example-18" class="section-header"><a href="#example-18">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">second</span>(), <span class="number">0</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>).<span class="ident">second</span>(), <span class="number">4</span>);</pre></div>
|
||||
<p>This method never returns 60 even when it is a leap second.
|
||||
(<a href="#leap-second-handling">Why?</a>)
|
||||
Use the proper <a href="#method.format">formatting method</a> to get a human-readable representation.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">second</span>(), <span class="number">59</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">format</span>(<span class="string">"%H:%M:%S"</span>).<span class="ident">to_string</span>(), <span class="string">"23:59:60"</span>);</pre></div>
|
||||
</div><h4 id="method.nanosecond" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.nanosecond" class="fnname">nanosecond</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#884-886" title="goto source code">[src]</a></h4><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="#leap-second-handling">leap second</a>.</p>
|
||||
<h1 id="example-19" class="section-header"><a href="#example-19">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">0</span>, <span class="number">0</span>, <span class="number">0</span>).<span class="ident">nanosecond</span>(), <span class="number">0</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>).<span class="ident">nanosecond</span>(), <span class="number">12_345_678</span>);</pre></div>
|
||||
<p>Leap seconds may have seemingly out-of-range return values.
|
||||
You can reduce the range with <code>time.nanosecond() % 1_000_000_000</code>, or
|
||||
use the proper <a href="#method.format">formatting method</a> to get a human-readable representation.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">let</span> <span class="ident">leap</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">nanosecond</span>(), <span class="number">1_000_000_000</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">leap</span>.<span class="ident">format</span>(<span class="string">"%H:%M:%S%.9f"</span>).<span class="ident">to_string</span>(), <span class="string">"23:59:60.000000000"</span>);</pre></div>
|
||||
</div><h4 id="method.with_hour" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.with_hour" class="fnname">with_hour</a>(&self, hour: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#902-908" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> with the hour number changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveTime</code> would be invalid.</p>
|
||||
<h1 id="example-20" class="section-header"><a href="#example-20">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_hour</span>(<span class="number">7</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">7</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_hour</span>(<span class="number">24</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.with_minute" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.with_minute" class="fnname">with_minute</a>(&self, min: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#924-930" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> with the minute number changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveTime</code> would be invalid.</p>
|
||||
<h1 id="example-21" class="section-header"><a href="#example-21">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_minute</span>(<span class="number">45</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">45</span>, <span class="number">4</span>, <span class="number">12_345_678</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_minute</span>(<span class="number">60</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.with_second" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.with_second" class="fnname">with_second</a>(&self, sec: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#948-954" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> with the second number changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveTime</code> would be invalid.
|
||||
As with the <a href="#method.second"><code>second</code></a> method,
|
||||
the input range is restricted to 0 through 59.</p>
|
||||
<h1 id="example-22" class="section-header"><a href="#example-22">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_second</span>(<span class="number">17</span>), <span class="prelude-val">Some</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">17</span>, <span class="number">12_345_678</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_second</span>(<span class="number">60</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
</div><h4 id="method.with_nanosecond" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#tymethod.with_nanosecond" class="fnname">with_nanosecond</a>(&self, nano: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/option/enum.Option.html" title="enum core::option::Option">Option</a><<a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a>></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#985-990" title="goto source code">[src]</a></h4><div class="docblock"><p>Makes a new <code>NaiveTime</code> with nanoseconds since the whole non-leap second changed.</p>
|
||||
<p>Returns <code>None</code> when the resulting <code>NaiveTime</code> would be invalid.
|
||||
As with the <a href="#method.nanosecond"><code>nanosecond</code></a> method,
|
||||
the input range can exceed 1,000,000,000 for leap seconds.</p>
|
||||
<h1 id="example-23" class="section-header"><a href="#example-23">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="kw">let</span> <span class="ident">dt</span> <span class="op">=</span> <span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_nanosecond</span>(<span class="number">333_333_333</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">333_333_333</span>)));
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_nanosecond</span>(<span class="number">2_000_000_000</span>), <span class="prelude-val">None</span>);</pre></div>
|
||||
<p>Leap seconds can theoretically follow <em>any</em> whole second.
|
||||
The following would be a proper leap second at the time zone offset of UTC-00:03:57
|
||||
(there are several historical examples comparable to this “non-sense” offset),
|
||||
and therefore is allowed.</p>
|
||||
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">dt</span>.<span class="ident">with_nanosecond</span>(<span class="number">1_333_333_333</span>),
|
||||
<span class="prelude-val">Some</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">1_333_333_333</span>)));</pre></div>
|
||||
</div><h4 id="method.num_seconds_from_midnight" class="method"><code>fn <a href="../../chrono/trait.Timelike.html#method.num_seconds_from_midnight" class="fnname">num_seconds_from_midnight</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a></code><a class="srclink" href="../../src/chrono/naive/time.rs.html#1007-1009" title="goto source code">[src]</a></h4><div class="docblock"><p>Returns the number of non-leap seconds past the last midnight.</p>
|
||||
<h1 id="example-24" class="section-header"><a href="#example-24">Example</a></h1>
|
||||
<div class="example-wrap"><pre class="rust rust-example-rendered">
|
||||
<span class="kw">use</span> <span class="ident">chrono</span>::{<span class="ident">NaiveTime</span>, <span class="ident">Timelike</span>};
|
||||
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms</span>(<span class="number">1</span>, <span class="number">2</span>, <span class="number">3</span>).<span class="ident">num_seconds_from_midnight</span>(),
|
||||
<span class="number">3723</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_nano</span>(<span class="number">23</span>, <span class="number">56</span>, <span class="number">4</span>, <span class="number">12_345_678</span>).<span class="ident">num_seconds_from_midnight</span>(),
|
||||
<span class="number">86164</span>);
|
||||
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">NaiveTime</span>::<span class="ident">from_hms_milli</span>(<span class="number">23</span>, <span class="number">59</span>, <span class="number">59</span>, <span class="number">1_000</span>).<span class="ident">num_seconds_from_midnight</span>(),
|
||||
<span class="number">86399</span>);</pre></div>
|
||||
</div><h4 id="method.hour12" class="method hidden"><code>fn <a href="../../chrono/trait.Timelike.html#method.hour12" class="fnname">hour12</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">(</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.bool.html">bool</a>, <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.tuple.html">)</a></code><a class="srclink" href="../../src/chrono/lib.rs.html#1370-1377" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Returns the hour number from 1 to 12 with a boolean flag,
|
||||
which is false for AM and true for PM. <a href="../../chrono/trait.Timelike.html#method.hour12">Read more</a></p>
|
||||
</div></div></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><h3 id="impl-RefUnwindSafe" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/std/panic/trait.RefUnwindSafe.html" title="trait std::panic::RefUnwindSafe">RefUnwindSafe</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-RefUnwindSafe" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Send" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Send" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Sync" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Sync" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-Unpin" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-Unpin" class="anchor"></a></h3><div class="impl-items"></div><h3 id="impl-UnwindSafe" class="impl"><code class="in-band">impl <a class="trait" href="https://doc.rust-lang.org/nightly/std/panic/trait.UnwindSafe.html" title="trait std::panic::UnwindSafe">UnwindSafe</a> for <a class="struct" href="../../chrono/naive/struct.NaiveTime.html" title="struct chrono::naive::NaiveTime">NaiveTime</a></code><a href="#impl-UnwindSafe" class="anchor"></a></h3><div class="impl-items"></div></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><h3 id="impl-Any" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T <span class="where fmt-newline">where<br> T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-Any" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#131-135" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.type_id" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html#tymethod.type_id" class="fnname">type_id</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/nightly/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/any.rs.html#132" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/nightly/core/any/trait.Any.html#tymethod.type_id">Read more</a></p>
|
||||
</div></div><h3 id="impl-Borrow%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-Borrow%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#207-211" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.borrow" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html#tymethod.borrow" class="fnname">borrow</a>(&self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&</a>T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#208" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></p>
|
||||
</div></div><h3 id="impl-BorrowMut%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a><T> for T <span class="where fmt-newline">where<br> T: ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-BorrowMut%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#214-218" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.borrow_mut" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fnname">borrow_mut</a>(&mut self) -> <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/borrow.rs.html#215" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/nightly/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></p>
|
||||
</div></div><h3 id="impl-From%3CT%3E" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html" title="trait core::convert::From">From</a><T> for T</code><a href="#impl-From%3CT%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#545-549" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html#tymethod.from" class="fnname">from</a>(t: T) -> T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#546" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-Into%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.From.html" title="trait core::convert::From">From</a><T>, </span></code><a href="#impl-Into%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#534-541" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html#tymethod.into" class="fnname">into</a>(self) -> U</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#538" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-ToOwned" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>, </span></code><a href="#impl-ToOwned" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#81-93" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Owned" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="type">Owned</a> = T</code></h4><div class='docblock'><p>The resulting type after obtaining ownership.</p>
|
||||
</div><h4 id="method.to_owned" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fnname">to_owned</a>(&self) -> T</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#86" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></p>
|
||||
</div><h4 id="method.clone_into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fnname">clone_into</a>(&self, target: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.reference.html">&mut </a>T)</code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/borrow.rs.html#90" title="goto source code">[src]</a></h4><div class="item-info hidden"><div class="stab unstable"><details><summary><span class="emoji">🔬</span> This is a nightly-only experimental API. (<code>toowned_clone_into</code>)</summary><p>recently added</p>
|
||||
</details></div></div><div class='docblock hidden'><p>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/nightly/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></p>
|
||||
</div></div><h3 id="impl-ToString" class="impl"><code class="in-band">impl<T> <a class="trait" href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html" title="trait alloc::string::ToString">ToString</a> for T <span class="where fmt-newline">where<br> T: <a class="trait" href="https://doc.rust-lang.org/nightly/core/fmt/trait.Display.html" title="trait core::fmt::Display">Display</a> + ?<a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>, </span></code><a href="#impl-ToString" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/string.rs.html#2205-2218" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="method.to_string" class="method hidden"><code>pub default fn <a href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html#tymethod.to_string" class="fnname">to_string</a>(&self) -> <a class="struct" href="https://doc.rust-lang.org/nightly/alloc/string/struct.String.html" title="struct alloc::string::String">String</a></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/alloc/string.rs.html#2211" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Converts the given value to a <code>String</code>. <a href="https://doc.rust-lang.org/nightly/alloc/string/trait.ToString.html#tymethod.to_string">Read more</a></p>
|
||||
</div></div><h3 id="impl-TryFrom%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a><T>, </span></code><a href="#impl-TryFrom%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#582-591" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Error" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" class="type">Error</a> = <a class="enum" href="https://doc.rust-lang.org/nightly/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></code></h4><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||||
</div><h4 id="method.try_from" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#tymethod.try_from" class="fnname">try_from</a>(value: U) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a><T, <T as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><U>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#588" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div><h3 id="impl-TryInto%3CU%3E" class="impl"><code class="in-band">impl<T, U> <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a><U> for T <span class="where fmt-newline">where<br> U: <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>, </span></code><a href="#impl-TryInto%3CU%3E" class="anchor"></a><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#568-577" title="goto source code">[src]</a></h3><div class="impl-items"><h4 id="associatedtype.Error-1" class="type"><code>type <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html#associatedtype.Error" class="type">Error</a> = <U as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></code></h4><div class='docblock'><p>The type returned in the event of a conversion error.</p>
|
||||
</div><h4 id="method.try_into" class="method hidden"><code>pub fn <a href="https://doc.rust-lang.org/nightly/core/convert/trait.TryInto.html#tymethod.try_into" class="fnname">try_into</a>(self) -> <a class="enum" href="https://doc.rust-lang.org/nightly/core/result/enum.Result.html" title="enum core::result::Result">Result</a><U, <U as <a class="trait" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a><T>>::<a class="type" href="https://doc.rust-lang.org/nightly/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>></code><a class="srclink" href="https://doc.rust-lang.org/nightly/src/core/convert/mod.rs.html#574" title="goto source code">[src]</a></h4><div class='docblock hidden'><p>Performs the conversion.</p>
|
||||
</div></div></div></section><section id="search" class="content hidden"></section><section class="footer"></section><div id="rustdoc-vars" data-root-path="../../" data-current-crate="chrono"></div>
|
||||
<script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>
|
||||
@@ -0,0 +1,10 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0;URL=../../../chrono/naive/struct.NaiveTime.html">
|
||||
</head>
|
||||
<body>
|
||||
<p>Redirecting to <a href="../../../chrono/naive/struct.NaiveTime.html">../../../chrono/naive/struct.NaiveTime.html</a>...</p>
|
||||
<script>location.replace("../../../chrono/naive/struct.NaiveTime.html" + location.search + location.hash);</script>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user