# Struct chrono::offset::Local [−] [src]

    pub struct Local;

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

### `impl Local` [src]

#### `pub fn today() -> Date<Local>` [src]

Returns a `Date` which corresponds to the current date.

#### `pub fn now() -> DateTime<Local>` [src]

Returns a `DateTime` which corresponds to the current date.

## Trait Implementations

### `impl Clone for Local` [src]

#### `fn clone(&self) -> Local` [src]

Returns a copy of the value. Read more

#### `pub fn clone_from(&mut self, source: &Self)`1.0.0 [src]

Performs copy-assignment from `source`. Read more

### `impl Copy for Local` [src]

### `impl Debug for Local` [src]

#### `fn fmt(&self, f: &mut Formatter<'_>) -> Result` [src]

Formats the value using the given formatter. Read more

### `impl TimeZone for Local` [src]

#### `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

#### `fn from_offset(_offset: &FixedOffset) -> Local` [src]

Reconstructs the time zone from the offset.

#### `fn offset_from_local_date(&self, local: &NaiveDate) -> LocalResult<FixedOffset>` [src]

Creates the offset(s) for given local `NaiveDate` if possible.

#### `fn offset_from_local_datetime(
&self,
local: &NaiveDateTime
) -> LocalResult<FixedOffset>` [src]

Creates the offset(s) for given local `NaiveDateTime` if possible.

#### `fn offset_from_utc_date(&self, utc: &NaiveDate) -> FixedOffset` [src]

Creates the offset for given UTC `NaiveDate`. This cannot fail.

#### `fn offset_from_utc_datetime(&self, utc: &NaiveDateTime) -> FixedOffset` [src]

Creates the offset for given UTC `NaiveDateTime`. This cannot fail.

#### `fn from_local_date(&self, local: &NaiveDate) -> LocalResult<Date<Local>>` [src]

Converts the local `NaiveDate` to the timezone-aware `Date` if possible.

#### `fn from_local_datetime(
&self,
local: &NaiveDateTime
) -> LocalResult<DateTime<Local>>` [src]

Converts the local `NaiveDateTime` to the timezone-aware `DateTime` if possible.

#### `fn from_utc_date(&self, utc: &NaiveDate) -> Date<Local>` [src]

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

#### `fn from_utc_datetime(&self, utc: &NaiveDateTime) -> DateTime<Local>` [src]

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

#### `fn ymd(&self, year: i32, month: u32, day: u32) -> Date<Self>` [src]

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

#### `fn ymd_opt(&self, year: i32, month: u32, day: u32) -> LocalResult<Date<Self>>` [src]

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

#### `fn yo(&self, year: i32, ordinal: u32) -> Date<Self>` [src]

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

#### `fn yo_opt(&self, year: i32, ordinal: u32) -> LocalResult<Date<Self>>` [src]

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

#### `fn isoywd(&self, year: i32, week: u32, weekday: Weekday) -> Date<Self>` [src]

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

#### `fn isoywd_opt(
&self,
year: i32,
week: u32,
weekday: Weekday
) -> LocalResult<Date<Self>>` [src]

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

#### `fn timestamp(&self, secs: i64, nsecs: u32) -> DateTime<Self>` [src]

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

#### `fn timestamp_opt(&self, secs: i64, nsecs: u32) -> LocalResult<DateTime<Self>>` [src]

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

#### `fn timestamp_millis(&self, millis: i64) -> DateTime<Self>` [src]

Makes a new `DateTime` from the number of non-leap milliseconds since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read more

#### `fn timestamp_millis_opt(&self, millis: i64) -> LocalResult<DateTime<Self>>` [src]

Makes a new `DateTime` from the number of non-leap milliseconds since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read more

#### `fn timestamp_nanos(&self, nanos: i64) -> DateTime<Self>` [src]

Makes a new `DateTime` from the number of non-leap nanoseconds since January 1, 1970 0:00:00 UTC (aka “UNIX timestamp”). Read more

#### `fn datetime_from_str(&self, s: &str, fmt: &str) -> ParseResult<DateTime<Self>>` [src]

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

## 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

### `impl<T> Any for T where
T: 'static + ?Sized,` [src]

#### `pub fn type_id(&self) -> TypeId` [src]

Gets the `TypeId` of `self`. Read more

### `impl<T> Borrow<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow(&self) -> &T` [src]

Immutably borrows from an owned value. Read more

### `impl<T> BorrowMut<T> for T where
T: ?Sized,` [src]

#### `pub fn borrow_mut(&mut self) -> &mut T` [src]

Mutably borrows from an owned value. Read more

### `impl<T> From<T> for T` [src]

#### `pub fn from(t: T) -> T` [src]

Performs the conversion.

### `impl<T, U> Into<U> for T where
U: From<T>,` [src]

#### `pub fn into(self) -> U` [src]

Performs the conversion.

### `impl<T> ToOwned for T where
T: Clone,` [src]

#### `type Owned = T`

The resulting type after obtaining ownership.

#### `pub fn to_owned(&self) -> T` [src]

Creates owned data from borrowed data, usually by cloning. Read more

#### `pub fn clone_into(&self, target: &mut T)` [src]

🔬 This is a nightly-only experimental API. (`toowned_clone_into`)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

### `impl<T, U> TryFrom<U> for T where
U: Into<T>,` [src]

#### `type Error = Infallible`

The type returned in the event of a conversion error.

#### `pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>` [src]

Performs the conversion.

### `impl<T, U> TryInto<U> for T where
U: TryFrom<T>,` [src]

#### `type Error = <U as TryFrom<T>>::Error`

The type returned in the event of a conversion error.

#### `pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>` [src]

Performs the conversion.