Struct UtcDateTime

pub struct UtcDateTime { /* private fields */ }

UTC date time exprimed in the proleptic gregorian calendar

Implementations

impl UtcDateTime

pub const fn new( year: i32, month: u8, month_day: u8, hour: u8, minute: u8, second: u8, nanoseconds: u32, ) -> Result<Self, DateTimeError>

Construct a UTC date time

Inputs

• year: Year
• month: Month in [1, 12]
• month_day: Day of the month in [1, 31]
• hour: Hours since midnight in [0, 23]
• minute: Minutes in [0, 59]
• second: Seconds in [0, 60], with a possible leap second
• nanoseconds: Nanoseconds in [0, 999_999_999]

pub const fn from_timespec( unix_time: i64, nanoseconds: u32, ) -> Result<Self, OutOfRangeError>

Construct a UTC date time from a Unix time in seconds and nanoseconds

pub const fn from_total_nanoseconds( total_nanoseconds: i128, ) -> Result<Self, OutOfRangeError>

Construct a UTC date time from total nanoseconds since Unix epoch (1970-01-01T00:00:00Z)

pub fn now() -> Result<Self, TzError>

Available on crate feature std only.

Returns the current UTC date time

pub const fn unix_time(&self) -> i64

Returns the Unix time in seconds associated to the UTC date time

pub const fn project( &self, time_zone_ref: TimeZoneRef<'_>, ) -> Result<DateTime, ProjectDateTimeError>

Project the UTC date time into a time zone.

Leap seconds are not preserved.

impl UtcDateTime

pub const fn year(&self) -> i32

Returns year

pub const fn month(&self) -> u8

Returns month in [1, 12]

pub const fn month_day(&self) -> u8

Returns day of the month in [1, 31]

pub const fn hour(&self) -> u8

Returns hours since midnight in [0, 23]

pub const fn minute(&self) -> u8

Returns minutes in [0, 59]

pub const fn second(&self) -> u8

Returns seconds in [0, 60], with a possible leap second

pub const fn nanoseconds(&self) -> u32

Returns nanoseconds in [0, 999_999_999]

pub const fn week_day(&self) -> u8

Returns days since Sunday in [0, 6]

pub const fn year_day(&self) -> u16

Returns days since January 1 in [0, 365]

pub const fn total_nanoseconds(&self) -> i128

Returns total nanoseconds since Unix epoch (1970-01-01T00:00:00Z)

Trait Implementations

impl Clone for UtcDateTime

fn clone(&self) -> UtcDateTime

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for UtcDateTime

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

Formats the value using the given formatter.

impl Display for UtcDateTime

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

Formats the value using the given formatter.

impl Ord for UtcDateTime

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

impl PartialEq for UtcDateTime

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for UtcDateTime

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

impl Eq for UtcDateTime

impl StructuralPartialEq for UtcDateTime