pnmixer-rust/chrono/offset/trait.TimeZone.html

231 lines
32 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

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

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="rustdoc">
<meta name="description" content="API documentation for the Rust `TimeZone` trait in crate `chrono`.">
<meta name="keywords" content="rust, rustlang, rust-lang, TimeZone">
<title>chrono::offset::TimeZone - Rust</title>
<link rel="stylesheet" type="text/css" href="../../normalize.css">
<link rel="stylesheet" type="text/css" href="../../rustdoc.css">
<link rel="stylesheet" type="text/css" href="../../main.css">
</head>
<body class="rustdoc trait">
<!--[if lte IE 8]>
<div class="warning">
This old browser is unsupported and will most likely display funky
things.
</div>
<![endif]-->
<nav class="sidebar">
<p class='location'>Trait TimeZone</p><div class="block items"><ul><li><a href="#associated-types">Associated Types</a></li><li><a href="#required-methods">Required Methods</a></li><li><a href="#provided-methods">Provided Methods</a></li><li><a href="#implementors">Implementors</a></li></ul></div><p class='location'><a href='../index.html'>chrono</a>::<wbr><a href='index.html'>offset</a></p><script>window.sidebarCurrent = {name: 'TimeZone', ty: 'trait', relpath: ''};</script><script defer src="sidebar-items.js"></script>
</nav>
<nav class="sub">
<form class="search-form js-only">
<div class="search-container">
<input class="search-input" name="search"
autocomplete="off"
placeholder="Click or press S to search, ? for more options…"
type="search">
</div>
</form>
</nav>
<section id='main' class="content">
<h1 class='fqn'><span class='in-band'>Trait <a href='../index.html'>chrono</a>::<wbr><a href='index.html'>offset</a>::<wbr><a class="trait" href=''>TimeZone</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'>&#x2212;</span>]
</a>
</span><a class='srclink' href='../../src/chrono/offset/mod.rs.html#167-329' title='goto source code'>[src]</a></span></h1>
<pre class='rust trait'>pub trait TimeZone: <a class="trait" href="https://doc.rust-lang.org/nightly/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a> + <a class="trait" href="https://doc.rust-lang.org/nightly/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> {
type <a href='#associatedtype.Offset' class="type">Offset</a>: <a class="trait" href="../../chrono/offset/trait.Offset.html" title="trait chrono::offset::Offset">Offset</a>;
fn <a href='#tymethod.from_offset' class='fnname'>from_offset</a>(offset: &amp;Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a>) -&gt; Self;
fn <a href='#tymethod.offset_from_local_date' class='fnname'>offset_from_local_date</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;local: &amp;<a class="struct" href="../../chrono/naive/date/struct.NaiveDate.html" title="struct chrono::naive::date::NaiveDate">NaiveDate</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a>&gt;;
fn <a href='#tymethod.offset_from_local_datetime' class='fnname'>offset_from_local_datetime</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;local: &amp;<a class="struct" href="../../chrono/naive/datetime/struct.NaiveDateTime.html" title="struct chrono::naive::datetime::NaiveDateTime">NaiveDateTime</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a>&gt;;
fn <a href='#tymethod.offset_from_utc_date' class='fnname'>offset_from_utc_date</a>(&amp;self, utc: &amp;<a class="struct" href="../../chrono/naive/date/struct.NaiveDate.html" title="struct chrono::naive::date::NaiveDate">NaiveDate</a>) -&gt; Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a>;
fn <a href='#tymethod.offset_from_utc_datetime' class='fnname'>offset_from_utc_datetime</a>(&amp;self, utc: &amp;<a class="struct" href="../../chrono/naive/datetime/struct.NaiveDateTime.html" title="struct chrono::naive::datetime::NaiveDateTime">NaiveDateTime</a>) -&gt; Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a>;
fn <a href='#method.ymd' class='fnname'>ymd</a>(&amp;self, 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>) -&gt; <a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt; { ... }
fn <a href='#method.ymd_opt' class='fnname'>ymd_opt</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;month: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;day: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;&gt; { ... }
fn <a href='#method.yo' class='fnname'>yo</a>(&amp;self, 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>) -&gt; <a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt; { ... }
fn <a href='#method.yo_opt' class='fnname'>yo_opt</a>(&amp;self, 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>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;&gt; { ... }
fn <a href='#method.isoywd' class='fnname'>isoywd</a>(&amp;self, 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>) -&gt; <a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt; { ... }
fn <a href='#method.isoywd_opt' class='fnname'>isoywd_opt</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;week: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;weekday: <a class="enum" href="../../chrono/enum.Weekday.html" title="enum chrono::Weekday">Weekday</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;&gt; { ... }
fn <a href='#method.timestamp' class='fnname'>timestamp</a>(&amp;self, 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>) -&gt; <a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt; { ... }
fn <a href='#method.timestamp_opt' class='fnname'>timestamp_opt</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;secs: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i64.html">i64</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;nsecs: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt;&gt; { ... }
fn <a href='#method.datetime_from_str' class='fnname'>datetime_from_str</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;s: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fmt: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) -&gt; <a class="type" href="../../chrono/format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a>&lt;<a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt;&gt; { ... }
fn <a href='#method.from_local_date' class='fnname'>from_local_date</a>(&amp;self, local: &amp;<a class="struct" href="../../chrono/naive/date/struct.NaiveDate.html" title="struct chrono::naive::date::NaiveDate">NaiveDate</a>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;&gt; { ... }
fn <a href='#method.from_local_datetime' class='fnname'>from_local_datetime</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;local: &amp;<a class="struct" href="../../chrono/naive/datetime/struct.NaiveDateTime.html" title="struct chrono::naive::datetime::NaiveDateTime">NaiveDateTime</a><br>&nbsp;&nbsp;&nbsp;&nbsp;) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt;&gt; { ... }
fn <a href='#method.from_utc_date' class='fnname'>from_utc_date</a>(&amp;self, utc: &amp;<a class="struct" href="../../chrono/naive/date/struct.NaiveDate.html" title="struct chrono::naive::date::NaiveDate">NaiveDate</a>) -&gt; <a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt; { ... }
fn <a href='#method.from_utc_datetime' class='fnname'>from_utc_datetime</a>(&amp;self, utc: &amp;<a class="struct" href="../../chrono/naive/datetime/struct.NaiveDateTime.html" title="struct chrono::naive::datetime::NaiveDateTime">NaiveDateTime</a>) -&gt; <a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt; { ... }
}</pre><div class='docblock'><p>The time zone.</p>
</div>
<h2 id='associated-types'>Associated Types</h2>
<div class='methods'>
<h3 id='associatedtype.Offset' class='method'><span id='Offset.t' class='invisible'><code>type <a href='#associatedtype.Offset' class="type">Offset</a>: <a class="trait" href="../../chrono/offset/trait.Offset.html" title="trait chrono::offset::Offset">Offset</a></code></span></h3><div class='docblock'><p>An associated offset type.
This type is used to store the actual offset in date and time types.
The original <code>TimeZone</code> value can be recovered via <code>TimeZone::from_offset</code>.</p>
</div></div>
<h2 id='required-methods'>Required Methods</h2>
<div class='methods'>
<h3 id='tymethod.from_offset' class='method'><span id='from_offset.v' class='invisible'><code>fn <a href='#tymethod.from_offset' class='fnname'>from_offset</a>(offset: &amp;Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a>) -&gt; Self</code></span></h3><div class='docblock'><p>Reconstructs the time zone from the offset.</p>
</div><h3 id='tymethod.offset_from_local_date' class='method'><span id='offset_from_local_date.v' class='invisible'><code>fn <a href='#tymethod.offset_from_local_date' class='fnname'>offset_from_local_date</a>(&amp;self, local: &amp;<a class="struct" href="../../chrono/naive/date/struct.NaiveDate.html" title="struct chrono::naive::date::NaiveDate">NaiveDate</a>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a>&gt;</code></span></h3><div class='docblock'><p>Creates the offset(s) for given local <code>NaiveDate</code> if possible.</p>
</div><h3 id='tymethod.offset_from_local_datetime' class='method'><span id='offset_from_local_datetime.v' class='invisible'><code>fn <a href='#tymethod.offset_from_local_datetime' class='fnname'>offset_from_local_datetime</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;local: &amp;<a class="struct" href="../../chrono/naive/datetime/struct.NaiveDateTime.html" title="struct chrono::naive::datetime::NaiveDateTime">NaiveDateTime</a><br>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a>&gt;</code></span></h3><div class='docblock'><p>Creates the offset(s) for given local <code>NaiveDateTime</code> if possible.</p>
</div><h3 id='tymethod.offset_from_utc_date' class='method'><span id='offset_from_utc_date.v' class='invisible'><code>fn <a href='#tymethod.offset_from_utc_date' class='fnname'>offset_from_utc_date</a>(&amp;self, utc: &amp;<a class="struct" href="../../chrono/naive/date/struct.NaiveDate.html" title="struct chrono::naive::date::NaiveDate">NaiveDate</a>) -&gt; Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a></code></span></h3><div class='docblock'><p>Creates the offset for given UTC <code>NaiveDate</code>. This cannot fail.</p>
</div><h3 id='tymethod.offset_from_utc_datetime' class='method'><span id='offset_from_utc_datetime.v' class='invisible'><code>fn <a href='#tymethod.offset_from_utc_datetime' class='fnname'>offset_from_utc_datetime</a>(&amp;self, utc: &amp;<a class="struct" href="../../chrono/naive/datetime/struct.NaiveDateTime.html" title="struct chrono::naive::datetime::NaiveDateTime">NaiveDateTime</a>) -&gt; Self::<a class="type" href="../../chrono/offset/trait.TimeZone.html#associatedtype.Offset" title="type chrono::offset::TimeZone::Offset">Offset</a></code></span></h3><div class='docblock'><p>Creates the offset for given UTC <code>NaiveDateTime</code>. This cannot fail.</p>
</div></div>
<h2 id='provided-methods'>Provided Methods</h2>
<div class='methods'>
<h3 id='method.ymd' class='method'><span id='ymd.v' class='invisible'><code>fn <a href='#method.ymd' class='fnname'>ymd</a>(&amp;self, 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>) -&gt; <a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;</code></span></h3><div class='docblock'><p>Makes a new <code>Date</code> from year, month, day and the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE.</p>
<p>The time zone normally does not affect the date (unless it is between UTC-24 and UTC+24),
but it will propagate to the <code>DateTime</code> values constructed via this date.</p>
<p>Panics on the out-of-range date, invalid month and/or day.</p>
</div><h3 id='method.ymd_opt' class='method'><span id='ymd_opt.v' class='invisible'><code>fn <a href='#method.ymd_opt' class='fnname'>ymd_opt</a>(&amp;self, 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>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;&gt;</code></span></h3><div class='docblock'><p>Makes a new <code>Date</code> from year, month, day and the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE.</p>
<p>The time zone normally does not affect the date (unless it is between UTC-24 and UTC+24),
but it will propagate to the <code>DateTime</code> values constructed via this date.</p>
<p>Returns <code>None</code> on the out-of-range date, invalid month and/or day.</p>
</div><h3 id='method.yo' class='method'><span id='yo.v' class='invisible'><code>fn <a href='#method.yo' class='fnname'>yo</a>(&amp;self, 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>) -&gt; <a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;</code></span></h3><div class='docblock'><p>Makes a new <code>Date</code> from year, day of year (DOY or &quot;ordinal&quot;) and the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE.</p>
<p>The time zone normally does not affect the date (unless it is between UTC-24 and UTC+24),
but it will propagate to the <code>DateTime</code> values constructed via this date.</p>
<p>Panics on the out-of-range date and/or invalid DOY.</p>
</div><h3 id='method.yo_opt' class='method'><span id='yo_opt.v' class='invisible'><code>fn <a href='#method.yo_opt' class='fnname'>yo_opt</a>(&amp;self, 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>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;&gt;</code></span></h3><div class='docblock'><p>Makes a new <code>Date</code> from year, day of year (DOY or &quot;ordinal&quot;) and the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE.</p>
<p>The time zone normally does not affect the date (unless it is between UTC-24 and UTC+24),
but it will propagate to the <code>DateTime</code> values constructed via this date.</p>
<p>Returns <code>None</code> on the out-of-range date and/or invalid DOY.</p>
</div><h3 id='method.isoywd' class='method'><span id='isoywd.v' class='invisible'><code>fn <a href='#method.isoywd' class='fnname'>isoywd</a>(&amp;self, 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>) -&gt; <a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;</code></span></h3><div class='docblock'><p>Makes a new <code>Date</code> from ISO week date (year and week number), day of the week (DOW) and
the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE.
The resulting <code>Date</code> may have a different year from the input year.</p>
<p>The time zone normally does not affect the date (unless it is between UTC-24 and UTC+24),
but it will propagate to the <code>DateTime</code> values constructed via this date.</p>
<p>Panics on the out-of-range date and/or invalid week number.</p>
</div><h3 id='method.isoywd_opt' class='method'><span id='isoywd_opt.v' class='invisible'><code>fn <a href='#method.isoywd_opt' class='fnname'>isoywd_opt</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;year: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.i32.html">i32</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;week: <a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.u32.html">u32</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;weekday: <a class="enum" href="../../chrono/enum.Weekday.html" title="enum chrono::Weekday">Weekday</a><br>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;&gt;</code></span></h3><div class='docblock'><p>Makes a new <code>Date</code> from ISO week date (year and week number), day of the week (DOW) and
the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE.
The resulting <code>Date</code> may have a different year from the input year.</p>
<p>The time zone normally does not affect the date (unless it is between UTC-24 and UTC+24),
but it will propagate to the <code>DateTime</code> values constructed via this date.</p>
<p>Returns <code>None</code> on the out-of-range date and/or invalid week number.</p>
</div><h3 id='method.timestamp' class='method'><span id='timestamp.v' class='invisible'><code>fn <a href='#method.timestamp' class='fnname'>timestamp</a>(&amp;self, 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>) -&gt; <a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt;</code></span></h3><div class='docblock'><p>Makes a new <code>DateTime</code> from the number of non-leap seconds
since January 1, 1970 0:00:00 UTC (aka &quot;UNIX timestamp&quot;)
and the number of nanoseconds since the last whole non-leap second.</p>
<p>Panics on the out-of-range number of seconds and/or invalid nanosecond.</p>
</div><h3 id='method.timestamp_opt' class='method'><span id='timestamp_opt.v' class='invisible'><code>fn <a href='#method.timestamp_opt' class='fnname'>timestamp_opt</a>(&amp;self, 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>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt;&gt;</code></span></h3><div class='docblock'><p>Makes a new <code>DateTime</code> from the number of non-leap seconds
since January 1, 1970 0:00:00 UTC (aka &quot;UNIX timestamp&quot;)
and the number of nanoseconds since the last whole non-leap second.</p>
<p>Returns <code>None</code> on the out-of-range number of seconds and/or invalid nanosecond.</p>
</div><h3 id='method.datetime_from_str' class='method'><span id='datetime_from_str.v' class='invisible'><code>fn <a href='#method.datetime_from_str' class='fnname'>datetime_from_str</a>(&amp;self, s: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>, fmt: &amp;<a class="primitive" href="https://doc.rust-lang.org/nightly/std/primitive.str.html">str</a>) -&gt; <a class="type" href="../../chrono/format/type.ParseResult.html" title="type chrono::format::ParseResult">ParseResult</a>&lt;<a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt;&gt;</code></span></h3><div class='docblock'><p>Parses a string with the specified format string and
returns a <code>DateTime</code> with the current offset.
See the <a href="../../format/strftime/index.html"><code>format::strftime</code> module</a>
on the supported escape sequences.</p>
<p>If the format does not include offsets, the current offset is assumed;
otherwise the input should have a matching UTC offset.</p>
<p>See also <code>DateTime::parse_from_str</code> which gives a local <code>DateTime</code>
with parsed <code>FixedOffset</code>.</p>
</div><h3 id='method.from_local_date' class='method'><span id='from_local_date.v' class='invisible'><code>fn <a href='#method.from_local_date' class='fnname'>from_local_date</a>(&amp;self, local: &amp;<a class="struct" href="../../chrono/naive/date/struct.NaiveDate.html" title="struct chrono::naive::date::NaiveDate">NaiveDate</a>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;&gt;</code></span></h3><div class='docblock'><p>Converts the local <code>NaiveDate</code> to the timezone-aware <code>Date</code> if possible.</p>
</div><h3 id='method.from_local_datetime' class='method'><span id='from_local_datetime.v' class='invisible'><code>fn <a href='#method.from_local_datetime' class='fnname'>from_local_datetime</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;local: &amp;<a class="struct" href="../../chrono/naive/datetime/struct.NaiveDateTime.html" title="struct chrono::naive::datetime::NaiveDateTime">NaiveDateTime</a><br>) -&gt; <a class="enum" href="../../chrono/offset/enum.LocalResult.html" title="enum chrono::offset::LocalResult">LocalResult</a>&lt;<a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt;&gt;</code></span></h3><div class='docblock'><p>Converts the local <code>NaiveDateTime</code> to the timezone-aware <code>DateTime</code> if possible.</p>
</div><h3 id='method.from_utc_date' class='method'><span id='from_utc_date.v' class='invisible'><code>fn <a href='#method.from_utc_date' class='fnname'>from_utc_date</a>(&amp;self, utc: &amp;<a class="struct" href="../../chrono/naive/date/struct.NaiveDate.html" title="struct chrono::naive::date::NaiveDate">NaiveDate</a>) -&gt; <a class="struct" href="../../chrono/date/struct.Date.html" title="struct chrono::date::Date">Date</a>&lt;Self&gt;</code></span></h3><div class='docblock'><p>Converts the UTC <code>NaiveDate</code> to the local time.
The UTC is continuous and thus this cannot fail (but can give the duplicate local time).</p>
</div><h3 id='method.from_utc_datetime' class='method'><span id='from_utc_datetime.v' class='invisible'><code>fn <a href='#method.from_utc_datetime' class='fnname'>from_utc_datetime</a>(&amp;self, utc: &amp;<a class="struct" href="../../chrono/naive/datetime/struct.NaiveDateTime.html" title="struct chrono::naive::datetime::NaiveDateTime">NaiveDateTime</a>) -&gt; <a class="struct" href="../../chrono/datetime/struct.DateTime.html" title="struct chrono::datetime::DateTime">DateTime</a>&lt;Self&gt;</code></span></h3><div class='docblock'><p>Converts the UTC <code>NaiveDateTime</code> to the local time.
The UTC is continuous and thus this cannot fail (but can give the duplicate local time).</p>
</div></div>
<h2 id='implementors'>Implementors</h2>
<ul class='item-list' id='implementors-list'>
<li><code>impl TimeZone for <a class="struct" href="../../chrono/offset/utc/struct.UTC.html" title="struct chrono::offset::utc::UTC">UTC</a></code></li>
<li><code>impl TimeZone for <a class="struct" href="../../chrono/offset/fixed/struct.FixedOffset.html" title="struct chrono::offset::fixed::FixedOffset">FixedOffset</a></code></li>
<li><code>impl TimeZone for <a class="struct" href="../../chrono/offset/local/struct.Local.html" title="struct chrono::offset::local::Local">Local</a></code></li>
</ul><script type="text/javascript" async
src="../../implementors/chrono/offset/trait.TimeZone.js">
</script></section>
<section id='search' class="content hidden"></section>
<section class="footer"></section>
<aside id="help" class="hidden">
<div>
<h1 class="hidden">Help</h1>
<div class="shortcuts">
<h2>Keyboard Shortcuts</h2>
<dl>
<dt>?</dt>
<dd>Show this help dialog</dd>
<dt>S</dt>
<dd>Focus the search field</dd>
<dt>&larrb;</dt>
<dd>Move up in search results</dd>
<dt>&rarrb;</dt>
<dd>Move down in search results</dd>
<dt>&#9166;</dt>
<dd>Go to active search result</dd>
<dt>+</dt>
<dd>Collapse/expand all sections</dd>
</dl>
</div>
<div class="infos">
<h2>Search Tricks</h2>
<p>
Prefix searches with a type followed by a colon (e.g.
<code>fn:</code>) to restrict the search to a given type.
</p>
<p>
Accepted types are: <code>fn</code>, <code>mod</code>,
<code>struct</code>, <code>enum</code>,
<code>trait</code>, <code>type</code>, <code>macro</code>,
and <code>const</code>.
</p>
<p>
Search functions by type signature (e.g.
<code>vec -> usize</code> or <code>* -> vec</code>)
</p>
</div>
</div>
</aside>
<script>
window.rootPath = "../../";
window.currentCrate = "chrono";
</script>
<script src="../../main.js"></script>
<script defer src="../../search-index.js"></script>
</body>
</html>