Struct Local 

pub struct Local;

The local system timezone as seen in Settings, from the persist.sys.timezone property.

Note that this ignores the TZ environment variable.

Implementations

impl Local

pub fn now() -> DateTime<Self>

Returns a DateTime<Local> for the current date, time and timezone offset.

Examples found in repository

examples/local_offsets.rs (line 18)

fn main() {
    println!("Local time: {}", Local::now());

    let winter = Utc.with_ymd_and_hms(2026, 3, 1, 12, 0, 0).unwrap();
    println!(
        "Offset at {winter}: {}",
        Local.offset_from_utc_datetime(&winter.naive_utc())
    );

    let summer = Utc.with_ymd_and_hms(2026, 4, 1, 12, 0, 0).unwrap();
    println!(
        "Offset at {summer}: {}",
        Local.offset_from_utc_datetime(&summer.naive_utc())
    );

    let winter_local = Local.with_ymd_and_hms(2026, 3, 1, 12, 0, 0).unwrap();
    println!(
        "Offset at {winter_local}: {:?}",
        Local.offset_from_local_datetime(&winter_local.naive_local())
    );

    let summer_local = Local.with_ymd_and_hms(2026, 4, 1, 12, 0, 0).unwrap();
    println!(
        "Offset at {summer_local}: {:?}",
        Local.offset_from_local_datetime(&summer_local.naive_local())
    );

    // Start of summer time in the UK and western Europe. This should be `None`.
    let start_local = NaiveDate::from_ymd_opt(2026, 3, 29)
        .unwrap()
        .and_hms_opt(1, 30, 0)
        .unwrap();
    println!(
        "At start of DST {start_local}: {:?}",
        Local.offset_from_local_datetime(&start_local)
    );

    // End of summer time in the UK and western Europe. This should be `Ambiguous`.
    let end_local = NaiveDate::from_ymd_opt(2026, 10, 25)
        .unwrap()
        .and_hms_opt(1, 30, 0)
        .unwrap();
    println!(
        "At end of DST {end_local}: {:?}",
        Local.offset_from_local_datetime(&end_local)
    );
}

Trait Implementations

impl Clone for Local

fn clone(&self) -> Local

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Local

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl TimeZone for Local

type Offset = TzOffset

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.

fn from_offset(_offset: &TzOffset) -> Self

Reconstructs the time zone from the offset.

fn offset_from_local_date(&self, local: &NaiveDate) -> MappedLocalTime<TzOffset>

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

fn offset_from_local_datetime( &self, local: &NaiveDateTime, ) -> MappedLocalTime<TzOffset>

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

fn offset_from_utc_date(&self, utc: &NaiveDate) -> TzOffset

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

fn offset_from_utc_datetime(&self, utc: &NaiveDateTime) -> TzOffset

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

fn with_ymd_and_hms( &self, year: i32, month: u32, day: u32, hour: u32, min: u32, sec: u32, ) -> LocalResult<DateTime<Self>>

Make a new DateTime from year, month, day, time components and current time zone.

fn ymd(&self, year: i32, month: u32, day: u32) -> Date<Self>

👎Deprecated since 0.4.23:

use with_ymd_and_hms() instead

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.

fn ymd_opt(&self, year: i32, month: u32, day: u32) -> LocalResult<Date<Self>>

👎Deprecated since 0.4.23:

use with_ymd_and_hms() instead

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.

fn yo(&self, year: i32, ordinal: u32) -> Date<Self>

👎Deprecated since 0.4.23:

use from_local_datetime() with a NaiveDateTime instead

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.

fn yo_opt(&self, year: i32, ordinal: u32) -> LocalResult<Date<Self>>

👎Deprecated since 0.4.23:

use from_local_datetime() with a NaiveDateTime instead

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.

fn isoywd(&self, year: i32, week: u32, weekday: Weekday) -> Date<Self>

👎Deprecated since 0.4.23:

use from_local_datetime() with a NaiveDateTime instead

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.

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

👎Deprecated since 0.4.23:

use from_local_datetime() with a NaiveDateTime instead

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.

fn timestamp(&self, secs: i64, nsecs: u32) -> DateTime<Self>

👎Deprecated since 0.4.23:

use timestamp_opt() instead

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.

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.

fn timestamp_millis(&self, millis: i64) -> DateTime<Self>

👎Deprecated since 0.4.23:

use timestamp_millis_opt() instead

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

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”).

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”).

fn timestamp_micros(&self, micros: i64) -> LocalResult<DateTime<Self>>

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

fn datetime_from_str( &self, s: &str, fmt: &str, ) -> Result<DateTime<Self>, ParseError>

👎Deprecated since 0.4.29:

use DateTime::parse_from_str or NaiveDateTime::parse_from_str with and_utc() or and_local_timezone() instead

Parses a string with the specified format string and returns a DateTime with the current offset.

fn from_local_date(&self, local: &NaiveDate) -> LocalResult<Date<Self>>

👎Deprecated since 0.4.23:

use from_local_datetime() instead

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

fn from_local_datetime( &self, local: &NaiveDateTime, ) -> LocalResult<DateTime<Self>>

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

fn from_utc_date(&self, utc: &NaiveDate) -> Date<Self>

👎Deprecated since 0.4.23:

use from_utc_datetime() instead

Converts the UTC NaiveDate to the local time. The UTC is continuous and thus this cannot fail (but can give the duplicate local time).

fn from_utc_datetime(&self, utc: &NaiveDateTime) -> DateTime<Self>

Converts the UTC NaiveDateTime to the local time. The UTC is continuous and thus this cannot fail (but can give the duplicate local time).

impl Copy for Local