Struct DateTimeOffset 

pub struct DateTimeOffset { /* private fields */ }

A date and time of day relative to UTC.

Equality, ordering and hashing consider the UTC instant only: two values with different offsets that name the same instant are equal, as in .NET (use equals_exact to compare the offsets too).

Implementations

impl DateTimeOffset

pub const MIN_VALUE: DateTimeOffset

The smallest value, 0001-01-01T00:00:00 +00:00.

pub const MAX_VALUE: DateTimeOffset

The largest value, 9999-12-31T23:59:59.9999999 +00:00.

pub const UNIX_EPOCH: DateTimeOffset

1970-01-01T00:00:00 +00:00.

pub fn new( year: i32, month: i32, day: i32, hour: i32, minute: i32, second: i32, offset: TimeSpan, ) -> DateTimeOffset

The given clock date and time at offset from UTC. Panics when the date and time are invalid, the offset is not a whole number of minutes within 14 hours of UTC, or the UTC instant is out of range.

pub fn try_new( year: i32, month: i32, day: i32, hour: i32, minute: i32, second: i32, offset: TimeSpan, ) -> Option<DateTimeOffset>

Like new; None instead of a panic.

pub fn from_ticks(ticks: i64, offset: TimeSpan) -> DateTimeOffset

The clock time with ticks ticks at offset from UTC. Panics when the ticks, the offset or the UTC instant are out of range.

pub fn from_date_time(date_time: DateTime) -> DateTimeOffset

The instant of a DateTime: a UTC value gets the offset zero, a local or unspecified value the local offset at that time (.NET new DateTimeOffset(DateTime)). Panics when the UTC instant is out of range.

pub fn from_date_time_offset( date_time: DateTime, offset: TimeSpan, ) -> DateTimeOffset

The clock time date_time at offset from UTC (.NET new DateTimeOffset(DateTime, TimeSpan)). Panics when the offset is invalid, when a UTC value is given a non-zero offset, when a local value is given an offset other than the local one, or when the UTC instant is out of range.

pub fn now() -> DateTimeOffset

The current date and time with the local offset.

pub fn utc_now() -> DateTimeOffset

The current date and time with the offset zero.

pub const fn offset(self) -> TimeSpan

The offset from UTC.

pub const fn date_time(self) -> DateTime

The clock date and time, of unspecified kind (.NET DateTime).

pub const fn utc_date_time(self) -> DateTime

The UTC date and time, of kind UTC (.NET UtcDateTime).

pub fn local_date_time(self) -> DateTime

The date and time in local time, of kind local (.NET LocalDateTime).

pub const fn date(self) -> DateTime

The clock date at midnight, of unspecified kind.

pub const fn time_of_day(self) -> TimeSpan

The clock time elapsed since midnight.

pub const fn ticks(self) -> i64

The ticks of the clock date and time.

pub const fn utc_ticks(self) -> i64

The ticks of the UTC date and time.

pub fn year(self) -> i32

The year of the clock date.

pub fn month(self) -> i32

The month of the clock date, 1..=12.

pub fn day(self) -> i32

The day of the month of the clock date, 1..=31.

pub fn day_of_year(self) -> i32

The day of the year of the clock date, 1..=366.

pub fn day_of_week(self) -> DayOfWeek

The day of the week of the clock date.

pub const fn hour(self) -> i32

The hour of the clock time, 0..=23.

pub const fn minute(self) -> i32

The minute of the clock time, 0..=59.

pub const fn second(self) -> i32

The second of the clock time, 0..=59.

pub const fn millisecond(self) -> i32

The millisecond of the clock time, 0..=999.

pub fn add(self, value: TimeSpan) -> DateTimeOffset

The value value later, with the same offset. Panics when out of range.

pub fn subtract(self, value: TimeSpan) -> DateTimeOffset

The value value earlier, with the same offset. Panics when out of range.

pub fn subtract_date_time_offset(self, other: DateTimeOffset) -> TimeSpan

The interval from other to this value (by UTC instants).

pub fn add_days(self, value: f64) -> DateTimeOffset

The value value days later. Panics when out of range.

pub fn add_months(self, months: i32) -> DateTimeOffset

The value months months later (see DateTime::add_months).

pub fn add_years(self, years: i32) -> DateTimeOffset

The value years years later (see DateTime::add_years).

pub fn to_offset(self, offset: TimeSpan) -> DateTimeOffset

The same instant at another offset. Panics when the offset is invalid or the clock time at that offset is out of range.

pub fn to_local_time(self) -> DateTimeOffset

The same instant at the local offset. A clock time that would leave the range keeps the instant and gets the offset zero.

pub const fn to_universal_time(self) -> DateTimeOffset

The same instant at the offset zero.

pub fn compare(first: DateTimeOffset, second: DateTimeOffset) -> i32

Compares two values by their UTC instants: -1, 0 or 1.

pub fn compare_to(self, other: DateTimeOffset) -> i32

Compares this value with other by their UTC instants: -1, 0 or 1.

pub fn equals_exact(self, other: DateTimeOffset) -> bool

Whether both the UTC instant and the offset are the same.

pub fn to_string_format( self, format: &str, provider: &(impl DateTimeFormatProvider + ?Sized), ) -> String

Formats with a standard or custom .NET date and time format string and the conventions of provider. An empty format gives the short date, the long time and the offset ("G" followed by zzz). Panics when the format string is invalid (.NET throws FormatException).

pub fn try_to_string_format( self, format: &str, provider: &(impl DateTimeFormatProvider + ?Sized), ) -> Result<String, FormatError>

Like to_string_format, but gives the error of an invalid format string.

pub fn to_string_with(self, format: &str) -> String

Formats with a format string and the conventions of the current culture (.NET ToString(string)). Panics when the format is invalid.

pub fn to_string_provider( self, provider: &(impl DateTimeFormatProvider + ?Sized), ) -> String

Formats with the default format and the conventions of provider (.NET ToString(IFormatProvider)).

impl DateTimeOffset

pub fn parse( text: &str, provider: &(impl DateTimeFormatProvider + ?Sized), ) -> Result<DateTimeOffset, FormatError>

Parses a date and time with an optional offset written in the conventions of provider (.NET DateTimeOffset.Parse(string, IFormatProvider)): the forms DateTime::parse accepts. The value has the offset the text states; a text without an offset is a local time and gets the local offset at that time, and a text without a date the current local date, as in .NET. The offset is Z, GMT, or a signed hh:mm, hhmm or h[h] after the time or the date. An offset of more than 14 hours and an instant outside of the years 1 to 9999 are errors.

Checked against results recorded from .NET for the invariant culture (date_time_tests.rs, date_time_offset_parse_matches_net). Not supported, as for DateTime::parse: what the heuristic parser of .NET accepts beyond those forms (other time zone names, era names, genitive month names), the DateTimeStyles overloads and ParseExact.

pub fn try_parse( text: &str, provider: &(impl DateTimeFormatProvider + ?Sized), ) -> Option<DateTimeOffset>

Parses like parse; None on failure (.NET DateTimeOffset.TryParse).

Trait Implementations

impl Add<TimeSpan> for DateTimeOffset

type Output = DateTimeOffset

The resulting type after applying the + operator.

fn add(self, rhs: TimeSpan) -> DateTimeOffset

Performs the + operation.

impl AddAssign<TimeSpan> for DateTimeOffset

fn add_assign(&mut self, rhs: TimeSpan)

Performs the += operation.

impl Clone for DateTimeOffset

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DateTimeOffset

impl Debug for DateTimeOffset

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

Formats the value using the given formatter.

impl Default for DateTimeOffset

fn default() -> Self

DateTimeOffset::MIN_VALUE, the C# default(DateTimeOffset).

impl Display for DateTimeOffset

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

The short date, long time and offset of the current culture (.NET ToString()).

impl Eq for DateTimeOffset

impl From<DateTime> for DateTimeOffset

fn from(value: DateTime) -> Self

The C# implicit conversion; see DateTimeOffset::from_date_time.

impl FromStr for DateTimeOffset

fn from_str(text: &str) -> Result<Self, Self::Err>

DateTimeOffset::parse: the invariant culture.

type Err = FormatError

The associated error which can be returned from parsing.

impl Hash for DateTimeOffset

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl MarkupTyped for DateTimeOffset

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl Ord for DateTimeOffset

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

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

Restrict a value to a certain range.

impl PartialEq for DateTimeOffset

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for DateTimeOffset

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Sub for DateTimeOffset

type Output = TimeSpan

The resulting type after applying the - operator.

fn sub(self, rhs: DateTimeOffset) -> TimeSpan

Performs the - operation.

impl Sub<TimeSpan> for DateTimeOffset

type Output = DateTimeOffset

The resulting type after applying the - operator.

fn sub(self, rhs: TimeSpan) -> DateTimeOffset

Performs the - operation.

impl SubAssign<TimeSpan> for DateTimeOffset

fn sub_assign(&mut self, rhs: TimeSpan)

Performs the -= operation.