Struct DateTime 

#[repr(C)]
pub struct DateTime {
    pub universal_time: i64,
}

Fields

universal_time: i64

Implementations

impl DateTime

pub const UNIX_EPOCH: DateTime

The DateTime value corresponding to 1970-01-01 00:00:00 UTC.

pub const MIN: DateTime

The minimum representable DateTime (i64::MIN ticks).

pub const MAX: DateTime

The maximum representable DateTime (i64::MAX ticks).

pub const TICKS_PER_SECOND: i64 = TICKS_PER_SECOND

The number of 100-nanosecond ticks per second (matches TimeSpan::TICKS_PER_SECOND).

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

Constructs a DateTime from a raw count of 100-nanosecond ticks since 1601-01-01 00:00:00 UTC.

pub const fn from_unix_secs(secs: i64) -> DateTime

Constructs a DateTime from a number of whole seconds since the Unix epoch, saturating on overflow.

pub const fn from_unix_millis(millis: i64) -> DateTime

Constructs a DateTime from a number of whole milliseconds since the Unix epoch, saturating on overflow.

pub const fn ticks(self) -> i64

Returns the raw count of 100-nanosecond ticks since 1601-01-01 UTC.

pub const fn unix_secs(self) -> i64

Returns the number of whole seconds between this DateTime and the Unix epoch. Negative for pre-1970 values.

pub const fn unix_millis(self) -> i64

Returns the number of whole milliseconds between this DateTime and the Unix epoch. Negative for pre-1970 values.

pub const fn unix_nanos(self) -> i128

Returns the number of nanoseconds between this DateTime and the Unix epoch, as an i128 to avoid overflow.

pub const fn checked_add(self, rhs: TimeSpan) -> Option<DateTime>

Checked addition of a TimeSpan. Returns None on overflow.

pub const fn checked_sub(self, rhs: TimeSpan) -> Option<DateTime>

Checked subtraction of a TimeSpan. Returns None on overflow.

pub const fn checked_duration_since(self, earlier: DateTime) -> Option<TimeSpan>

Returns the signed duration from earlier to self. Returns None on overflow.

pub const fn saturating_add(self, rhs: TimeSpan) -> DateTime

Saturating addition of a TimeSpan.

pub const fn saturating_sub(self, rhs: TimeSpan) -> DateTime

Saturating subtraction of a TimeSpan.

pub fn now() -> DateTime

Returns the current DateTime from the system clock.

pub fn to_local(self) -> DateTime

Converts this DateTime from UTC to local time by applying the system’s current timezone offset (including DST adjustments).

The returned DateTime has its ticks shifted so that the decomposition methods (year, month, day, etc.) return local calendar values.

Example

use windows_time::DateTime;

let local = DateTime::now().to_local();
println!("{:02}:{:02}:{:02}", local.hour(), local.minute(), local.second());

pub const fn year(self) -> i64

The year component of this DateTime.

pub const fn month(self) -> u32

The month component (1 = January, 12 = December).

pub const fn day(self) -> u32

The day of the month (1-31).

pub const fn hour(self) -> u32

The hour (0-23).

pub const fn minute(self) -> u32

The minute (0-59).

pub const fn second(self) -> u32

The second (0-59).

pub const fn milliseconds(self) -> u32

The milliseconds (0-999).

pub const fn day_of_week(self) -> u32

The day of the week (0 = Sunday, 6 = Saturday).

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) -> DateTime

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<(), Error>

Formats the value using the given formatter.

impl Default for DateTime

fn default() -> DateTime

Returns the “default value” for a type.

impl Display for DateTime

ISO-8601 UTC formatting: YYYY-MM-DDTHH:MM:SS.fffffffZ. The fractional part is omitted when zero. Year is at least 4 digits, padded with a leading - for negative years.

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

Formats the value using the given formatter.

impl Eq for DateTime

impl Hash for DateTime

fn hash<H>(&self, state: &mut H)

where H: Hasher,

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 Ord for DateTime

fn cmp(&self, other: &DateTime) -> 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: &DateTime) -> bool

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for DateTime

fn partial_cmp(&self, other: &DateTime) -> 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 StructuralPartialEq for DateTime

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.

impl TryFrom<SystemTime> for DateTime

Available on crate feature std only.

type Error = TimeRangeError

The type returned in the event of a conversion error.

fn try_from( value: SystemTime, ) -> Result<DateTime, <DateTime as TryFrom<SystemTime>>::Error>

Performs the conversion.