Struct chrono::offset::FixedOffset

[+] Show declaration

pub struct FixedOffset { /* fields omitted */ }

[−] Expand description

The time zone with fixed offset, from UTC-23:59:59 to UTC+23:59:59.

Using the TimeZone methods on a FixedOffset struct is the preferred way to construct DateTime<FixedOffset> instances. See the east and west methods for examples.

Methods

impl FixedOffset[−]

pub fn east(secs: i32) -> FixedOffset[+]

Makes a new FixedOffset for the Eastern Hemisphere with given timezone difference. The negative secs means the Western Hemisphere.

Panics on the out-of-bound secs.

Example

use chrono::{FixedOffset, TimeZone};
let hour = 3600;
let datetime = FixedOffset::east(5 * hour).ymd(2016, 11, 08)
                                          .and_hms(0, 0, 0);
assert_eq!(&datetime.to_rfc3339(), "2016-11-08T00:00:00+05:00")

pub fn east_opt(secs: i32) -> Option<FixedOffset>[+]

Makes a new FixedOffset for the Eastern Hemisphere with given timezone difference. The negative secs means the Western Hemisphere.

Returns None on the out-of-bound secs.

pub fn west(secs: i32) -> FixedOffset[+]

Makes a new FixedOffset for the Western Hemisphere with given timezone difference. The negative secs means the Eastern Hemisphere.

Panics on the out-of-bound secs.

Example

use chrono::{FixedOffset, TimeZone};
let hour = 3600;
let datetime = FixedOffset::west(5 * hour).ymd(2016, 11, 08)
                                          .and_hms(0, 0, 0);
assert_eq!(&datetime.to_rfc3339(), "2016-11-08T00:00:00-05:00")

pub fn west_opt(secs: i32) -> Option<FixedOffset>[+]

Makes a new FixedOffset for the Western Hemisphere with given timezone difference. The negative secs means the Eastern Hemisphere.

Returns None on the out-of-bound secs.

pub fn local_minus_utc(&self) -> i32[+]

Returns the number of seconds to add to convert from UTC to the local time.

pub fn utc_minus_local(&self) -> i32[+]

Returns the number of seconds to add to convert from the local time to UTC.

Trait Implementations

impl Offset for FixedOffset[+]

[+] Show hidden undocumented items

fn fix(&self) -> FixedOffset[+]

Returns the fixed offset from UTC to the local time stored.

impl TimeZone for FixedOffset[+]

[+] Show hidden undocumented items

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.

fn from_offset(offset: &FixedOffset) -> FixedOffset[+]

Reconstructs the time zone from the offset.

fn offset_from_local_date(&self, _local: &NaiveDate) -> LocalResult<FixedOffset>[+]

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

fn offset_from_local_datetime(
    &self,
    _local: &NaiveDateTime
) -> LocalResult<FixedOffset>[+]

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

fn offset_from_utc_date(&self, _utc: &NaiveDate) -> FixedOffset[+]

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

fn offset_from_utc_datetime(&self, _utc: &NaiveDateTime) -> FixedOffset[+]

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

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.

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.

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.

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.

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.

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.

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.

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>[+]

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

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

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>[+]

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 Eq for FixedOffset

impl Copy for FixedOffset

impl PartialEq<FixedOffset> for FixedOffset[+]

[+] Show hidden undocumented items

fn eq(&self, other: &FixedOffset) -> bool[+]

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &FixedOffset) -> bool[+]

This method tests for !=.

impl Clone for FixedOffset[+]

[+] Show hidden undocumented items

fn clone(&self) -> FixedOffset[+]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)[+]

Performs copy-assignment from source.

impl Display for FixedOffset[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter) -> Result[+]

Formats the value using the given formatter.

impl Debug for FixedOffset[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter) -> Result[+]

Formats the value using the given formatter.

impl Add<FixedOffset> for NaiveTime[+]

[+] Show hidden undocumented items

type Output = NaiveTime

The resulting type after applying the + operator.

fn add(self, rhs: FixedOffset) -> NaiveTime[+]

Performs the + operation.

impl Add<FixedOffset> for NaiveDateTime[+]

[+] Show hidden undocumented items

type Output = NaiveDateTime

The resulting type after applying the + operator.

fn add(self, rhs: FixedOffset) -> NaiveDateTime[+]

Performs the + operation.

impl<Tz: TimeZone> Add<FixedOffset> for DateTime<Tz>[+]

[+] Show hidden undocumented items

type Output = DateTime<Tz>

The resulting type after applying the + operator.

fn add(self, rhs: FixedOffset) -> DateTime<Tz>[+]

Performs the + operation.

impl Sub<FixedOffset> for NaiveTime[+]

[+] Show hidden undocumented items

type Output = NaiveTime

The resulting type after applying the - operator.

fn sub(self, rhs: FixedOffset) -> NaiveTime[+]

Performs the - operation.

impl Sub<FixedOffset> for NaiveDateTime[+]

[+] Show hidden undocumented items

type Output = NaiveDateTime

The resulting type after applying the - operator.

fn sub(self, rhs: FixedOffset) -> NaiveDateTime[+]

Performs the - operation.

impl<Tz: TimeZone> Sub<FixedOffset> for DateTime<Tz>[+]

[+] Show hidden undocumented items

type Output = DateTime<Tz>

The resulting type after applying the - operator.

fn sub(self, rhs: FixedOffset) -> DateTime<Tz>[+]

Performs the - operation.

impl Hash for FixedOffset[+]

[+] Show hidden undocumented items

fn hash<__H: Hasher>(&self, state: &mut __H)[+]

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, [+]

Feeds a slice of this type into the given [Hasher].