pub struct Local;
Expand description
The local timescale. This is implemented via the standard time
crate.
Using the TimeZone
methods
on the Local struct is the preferred way to construct DateTime<Local>
instances.
Example
use chrono::{Local, DateTime, TimeZone};
let dt: DateTime<Local> = Local::now();
let dt: DateTime<Local> = Local.timestamp(0, 0);
Implementations
Trait Implementations
sourceimpl TimeZone for Local
impl TimeZone for Local
type Offset = FixedOffset
type Offset = FixedOffset
An associated offset type.
This type is used to store the actual offset in date and time types.
The original TimeZone
value can be recovered via TimeZone::from_offset
. Read more
sourcefn from_offset(_offset: &FixedOffset) -> Local
fn from_offset(_offset: &FixedOffset) -> Local
Reconstructs the time zone from the offset.
sourcefn offset_from_local_date(&self, local: &NaiveDate) -> LocalResult<FixedOffset>
fn offset_from_local_date(&self, local: &NaiveDate) -> LocalResult<FixedOffset>
Creates the offset(s) for given local NaiveDate
if possible.
sourcefn offset_from_local_datetime(
&self,
local: &NaiveDateTime
) -> LocalResult<FixedOffset>
fn offset_from_local_datetime(
&self,
local: &NaiveDateTime
) -> LocalResult<FixedOffset>
Creates the offset(s) for given local NaiveDateTime
if possible.
sourcefn offset_from_utc_date(&self, utc: &NaiveDate) -> FixedOffset
fn offset_from_utc_date(&self, utc: &NaiveDate) -> FixedOffset
Creates the offset for given UTC NaiveDate
. This cannot fail.
sourcefn offset_from_utc_datetime(&self, utc: &NaiveDateTime) -> FixedOffset
fn offset_from_utc_datetime(&self, utc: &NaiveDateTime) -> FixedOffset
Creates the offset for given UTC NaiveDateTime
. This cannot fail.
sourcefn from_local_date(&self, local: &NaiveDate) -> LocalResult<Date<Local>>
fn from_local_date(&self, local: &NaiveDate) -> LocalResult<Date<Local>>
Converts the local NaiveDate
to the timezone-aware Date
if possible.
sourcefn from_local_datetime(
&self,
local: &NaiveDateTime
) -> LocalResult<DateTime<Local>>
fn from_local_datetime(
&self,
local: &NaiveDateTime
) -> LocalResult<DateTime<Local>>
Converts the local NaiveDateTime
to the timezone-aware DateTime
if possible.
sourcefn from_utc_date(&self, utc: &NaiveDate) -> Date<Local>
fn from_utc_date(&self, utc: &NaiveDate) -> Date<Local>
Converts the UTC NaiveDate
to the local time.
The UTC is continuous and thus this cannot fail (but can give the duplicate local time). Read more
sourcefn from_utc_datetime(&self, utc: &NaiveDateTime) -> DateTime<Local>
fn from_utc_datetime(&self, utc: &NaiveDateTime) -> DateTime<Local>
Converts the UTC NaiveDateTime
to the local time.
The UTC is continuous and thus this cannot fail (but can give the duplicate local time). Read more
sourcefn ymd(&self, year: i32, month: u32, day: u32) -> Date<Self>
fn ymd(&self, year: i32, month: u32, day: u32) -> Date<Self>
Makes a new Date
from year, month, day and the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. Read more
sourcefn ymd_opt(&self, year: i32, month: u32, day: u32) -> LocalResult<Date<Self>>
fn ymd_opt(&self, year: i32, month: u32, day: u32) -> LocalResult<Date<Self>>
Makes a new Date
from year, month, day and the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. Read more
sourcefn yo(&self, year: i32, ordinal: u32) -> Date<Self>
fn yo(&self, year: i32, ordinal: u32) -> Date<Self>
Makes a new Date
from year, day of year (DOY or “ordinal”) and the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. Read more
sourcefn yo_opt(&self, year: i32, ordinal: u32) -> LocalResult<Date<Self>>
fn yo_opt(&self, year: i32, ordinal: u32) -> LocalResult<Date<Self>>
Makes a new Date
from year, day of year (DOY or “ordinal”) and the current time zone.
This assumes the proleptic Gregorian calendar, with the year 0 being 1 BCE. Read more
sourcefn isoywd(&self, year: i32, week: u32, weekday: Weekday) -> Date<Self>
fn isoywd(&self, year: i32, week: u32, weekday: Weekday) -> Date<Self>
Makes a new Date
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 Date
may have a different year from the input year. Read more
sourcefn isoywd_opt(
&self,
year: i32,
week: u32,
weekday: Weekday
) -> LocalResult<Date<Self>>
fn isoywd_opt(
&self,
year: i32,
week: u32,
weekday: Weekday
) -> LocalResult<Date<Self>>
Makes a new Date
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 Date
may have a different year from the input year. Read more
sourcefn timestamp(&self, secs: i64, nsecs: u32) -> DateTime<Self>
fn timestamp(&self, secs: i64, nsecs: u32) -> DateTime<Self>
Makes a new DateTime
from the number of non-leap seconds
since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”)
and the number of nanoseconds since the last whole non-leap second. Read more
sourcefn timestamp_opt(&self, secs: i64, nsecs: u32) -> LocalResult<DateTime<Self>>
fn timestamp_opt(&self, secs: i64, nsecs: u32) -> LocalResult<DateTime<Self>>
Makes a new DateTime
from the number of non-leap seconds
since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”)
and the number of nanoseconds since the last whole non-leap second. Read more
sourcefn timestamp_millis(&self, millis: i64) -> DateTime<Self>
fn timestamp_millis(&self, millis: i64) -> DateTime<Self>
Makes a new DateTime
from the number of non-leap milliseconds
since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read more
sourcefn timestamp_millis_opt(&self, millis: i64) -> LocalResult<DateTime<Self>>
fn timestamp_millis_opt(&self, millis: i64) -> LocalResult<DateTime<Self>>
Makes a new DateTime
from the number of non-leap milliseconds
since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read more
sourcefn timestamp_nanos(&self, nanos: i64) -> DateTime<Self>
fn timestamp_nanos(&self, nanos: i64) -> DateTime<Self>
Makes a new DateTime
from the number of non-leap nanoseconds
since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read more
sourcefn datetime_from_str(&self, s: &str, fmt: &str) -> ParseResult<DateTime<Self>>
fn datetime_from_str(&self, s: &str, fmt: &str) -> ParseResult<DateTime<Self>>
Parses a string with the specified format string and
returns a DateTime
with the current offset.
See the format::strftime
module
on the supported escape sequences. Read more
impl Copy for Local
Auto Trait Implementations
impl RefUnwindSafe for Local
impl Send for Local
impl Sync for Local
impl Unpin for Local
impl UnwindSafe for Local
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more