Struct DateTime 

pub struct DateTime { /* private fields */ }

A date and time of day with a resolution of 100 nanoseconds.

Equality, ordering and hashing consider the ticks only; the kind is ignored, as in .NET.

Implementations

impl DateTime

pub const MIN_VALUE: DateTime

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

pub const MAX_VALUE: DateTime

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

pub const UNIX_EPOCH: DateTime

1970-01-01T00:00:00 UTC.

pub fn new(year: i32, month: i32, day: i32) -> DateTime

The date year-month-day at midnight, of unspecified kind. Panics when the arguments do not name a date in 0001..=9999.

pub fn new_with_time( year: i32, month: i32, day: i32, hour: i32, minute: i32, second: i32, ) -> DateTime

The given date and time of day, of unspecified kind. Panics when the arguments do not name a valid date and time.

pub fn new_with_millisecond( year: i32, month: i32, day: i32, hour: i32, minute: i32, second: i32, millisecond: i32, ) -> DateTime

The given date and time of day with milliseconds, of unspecified kind. Panics when the arguments do not name a valid date and time.

pub fn try_new(year: i32, month: i32, day: i32) -> Option<DateTime>

The date year-month-day at midnight; None when the arguments do not name a date in 0001..=9999.

pub fn try_new_with_time( year: i32, month: i32, day: i32, hour: i32, minute: i32, second: i32, ) -> Option<DateTime>

The given date and time of day; None when the arguments do not name a valid date and time.

pub const fn from_ticks(ticks: i64) -> DateTime

The value with the given number of ticks, of unspecified kind. Panics when ticks is outside the range of the type.

pub const fn from_ticks_kind(ticks: i64, kind: DateTimeKind) -> DateTime

The value with the given number of ticks and kind. Panics when ticks is outside the range of the type.

pub const fn try_from_ticks(ticks: i64, kind: DateTimeKind) -> Option<DateTime>

The value with the given number of ticks; None when out of range.

pub const fn specify_kind(self, kind: DateTimeKind) -> DateTime

The same ticks with another kind (.NET DateTime.SpecifyKind).

pub fn set_utc_now_provider( provider: Option<UtcNowProvider>, ) -> Option<UtcNowProvider>

Installs (or with None removes) the source of the current UTC time of the current thread and returns the previous one. Tests use it to pin now, utc_now and today.

pub fn utc_now() -> DateTime

The current date and time in UTC (kind DateTimeKind::Utc): the time of the pinned source of this thread (set_utc_now_provider) when there is one, else the wall clock of the registered IRuntimePlatform, else the one of the standard runtime platform.

pub fn now() -> DateTime

The current date and time in local time (kind DateTimeKind::Local).

pub fn today() -> DateTime

The current local date at midnight (kind DateTimeKind::Local).

pub const fn ticks(self) -> i64

The number of ticks since 0001-01-01T00:00:00.

pub const fn kind(self) -> DateTimeKind

The kind of time.

pub const fn date(self) -> DateTime

The date at midnight, with the same kind.

pub const fn time_of_day(self) -> TimeSpan

The time elapsed since midnight.

pub fn year(self) -> i32

The year, 1..=9999.

pub fn month(self) -> i32

The month, 1..=12.

pub fn day(self) -> i32

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

pub fn day_of_year(self) -> i32

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

pub fn day_of_week(self) -> DayOfWeek

The day of the week.

pub const fn hour(self) -> i32

The hour, 0..=23.

pub const fn minute(self) -> i32

The minute, 0..=59.

pub const fn second(self) -> i32

The second, 0..=59.

pub const fn millisecond(self) -> i32

The millisecond, 0..=999.

pub fn is_leap_year(year: i32) -> bool

Whether year (1..=9999) is a leap year. Panics for other years.

pub fn days_in_month(year: i32, month: i32) -> i32

The number of days of month in year. Panics when the month is not 1..=12 or the year not 1..=9999.

pub const fn try_add_ticks(self, ticks: i64) -> Option<DateTime>

The value ticks later; None when out of range.

pub fn add_ticks(self, ticks: i64) -> DateTime

The value ticks later. Panics when out of range.

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

The value value later. Panics when out of range.

pub fn try_add(self, value: TimeSpan) -> Option<DateTime>

The value value later; None when out of range.

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

The value value earlier. Panics when out of range.

pub fn subtract_date_time(self, other: DateTime) -> TimeSpan

The interval from other to this value.

pub fn try_add_days(self, value: f64) -> Option<DateTime>

The value value (whole and fractional) days later; None when out of range.

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

The value value (whole and fractional) days later. Panics when out of range.

pub fn try_add_months(self, months: i32) -> Option<DateTime>

The value months months later (earlier when negative). The day is kept, or becomes the last day of the resulting month when that month is shorter. None when months is not in -120000..=120000 or the result is out of range.

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

The value months months later; see try_add_months. Panics when months or the result is out of range.

pub fn try_add_years(self, years: i32) -> Option<DateTime>

The value years years later (earlier when negative); February 29 becomes February 28 in a year that is not a leap year. None when years is not in -10000..=10000 or the result is out of range.

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

The value years years later; see try_add_years. Panics when years or the result is out of range.

pub fn compare(t1: DateTime, t2: DateTime) -> i32

Compares two values by their ticks: negative, zero or positive (.NET DateTime.Compare, which returns -1, 0 or 1).

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

Compares this value with other: -1, 0 or 1.

pub fn to_universal_time(self) -> DateTime

The value converted to UTC. A value of unspecified kind is taken as local time. A result outside the range is clamped to it.

pub fn to_local_time(self) -> DateTime

The value converted to local time. A value of unspecified kind is taken as UTC. A result outside the range is clamped to it.

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 (a CultureInfo or a DateTimeFormatInfo). An empty format is the general format "G". 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 general format "G" and the conventions of provider (.NET ToString(IFormatProvider)).

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

Parses a date and time written in the conventions of provider (.NET DateTime.Parse(string, IFormatProvider)).

This is not the heuristic parser of .NET. It is checked against results recorded from .NET (date_time_net_data.rs, tables PARSE, PARSE_ROUND_TRIP and PARSE_STYLES) for the invariant culture, en, en-US and en-GB, which covers what the date picker feeds it: the text it writes itself with the short and the long date pattern of the culture, and typed dates of these forms:

• numeric dates with /, -, . or spaces in the order of the short date pattern; a year of three or more digits written first gives year-month-day; two-digit years are 1950..=2049;
• month names and abbreviations (of the culture or English), with the day before or after and an optional, matching day name;
• a month and a year alone (the first of the month), a month and a day alone (the current year);
• an offset from UTC (Z, GMT, a signed hh:mm, hhmm or h[h]) after the time or after a date without a time; the result is then the local time of that instant;
• ISO 8601 yyyy-MM-ddTHH:mm:ss[.fffffff] with Z or an offset, the sortable, universal sortable and RFC 1123 formats;
• a time H:mm[:ss[.fffffff]] with an optional designator before or after the date, or alone (the current date).

Everything else is rejected, and has not been compared with .NET beyond the recorded rows: other time zone names than GMT and Z (.NET rejects UTC too), era names, a two-number date that is only valid in the order the culture does not use, and the inflected (genitive) month names of cultures that have them, which .NET accepts.

pub fn parse_with_styles( text: &str, provider: &(impl DateTimeFormatProvider + ?Sized), styles: DateTimeStyles, ) -> Result<DateTime, FormatError>

Parses a date and time written in the conventions of provider (.NET DateTime.Parse(string, IFormatProvider, DateTimeStyles)).

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

Parses like parse_with_styles; None on failure (.NET DateTime.TryParse).

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

Parses a date and time that has to match format exactly (.NET DateTime.ParseExact(string, string, IFormatProvider)).

pub fn parse_exact_with_styles( text: &str, format: &str, provider: &(impl DateTimeFormatProvider + ?Sized), styles: DateTimeStyles, ) -> Result<DateTime, FormatError>

Parses a date and time that has to match format exactly (.NET DateTime.ParseExact(string, string, IFormatProvider, DateTimeStyles)).

pub fn parse_exact_multiple( text: &str, formats: &[&str], provider: &(impl DateTimeFormatProvider + ?Sized), styles: DateTimeStyles, ) -> Result<DateTime, FormatError>

Parses a date and time that has to match one of formats exactly; the first format that matches wins (.NET DateTime.ParseExact(string, string[], ..)).

pub fn try_parse_exact( text: &str, format: &str, provider: &(impl DateTimeFormatProvider + ?Sized), styles: DateTimeStyles, ) -> Option<DateTime>

Like parse_exact_with_styles; None on failure (.NET DateTime.TryParseExact(string, string, ..)).

pub fn try_parse_exact_multiple( text: &str, formats: &[&str], provider: &(impl DateTimeFormatProvider + ?Sized), styles: DateTimeStyles, ) -> Option<DateTime>

Like parse_exact_multiple; None on failure (.NET DateTime.TryParseExact(string, string[], ..)).

Trait Implementations

impl Add<TimeSpan> for DateTime

type Output = DateTime

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<TimeSpan> for DateTime

fn add_assign(&mut self, rhs: TimeSpan)

Performs the += operation.

impl Clone for DateTime

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 DateTime

impl Debug for DateTime

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

Formats the value using the given formatter.

impl Default for DateTime

fn default() -> Self

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

impl Display for DateTime

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

The general format "G" of the current culture (.NET ToString()).

impl Eq for DateTime

impl From<DateTime> for DateTimeOffset

fn from(value: DateTime) -> Self

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

impl FromStr for DateTime

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

Parses with the conventions of the current culture (.NET DateTime.Parse(string)).

type Err = FormatError

The associated error which can be returned from parsing.

impl Hash for DateTime

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 DateTime

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl Ord for DateTime

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 DateTime

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for DateTime

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 DateTime

type Output = TimeSpan

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<TimeSpan> for DateTime

type Output = DateTime

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<TimeSpan> for DateTime

fn sub_assign(&mut self, rhs: TimeSpan)

Performs the -= operation.