pub struct DateTime { /* private fields */ }
Expand description
DateTime in time.
DateTime in time represented as seconds and sub-second nanos since the Unix epoch (January 1, 1970 at midnight UTC/GMT).
This type can be converted to/from the standard library’s SystemTime
:
use std::convert::TryFrom;
let the_millennium_as_system_time = SystemTime::try_from(DateTime::from_secs(946_713_600))?;
let now_as_date_time = DateTime::from(SystemTime::now());
The aws-smithy-types-convert
crate
can be used for conversions to/from other libraries, such as
time
or chrono
.
Implementations§
Source§impl DateTime
impl DateTime
Sourcepub fn from_secs(epoch_seconds: i64) -> DateTime
pub fn from_secs(epoch_seconds: i64) -> DateTime
Creates a DateTime
from a number of seconds since the Unix epoch.
Sourcepub fn from_millis(epoch_millis: i64) -> DateTime
pub fn from_millis(epoch_millis: i64) -> DateTime
Creates a DateTime
from a number of milliseconds since the Unix epoch.
Sourcepub fn from_nanos(epoch_nanos: i128) -> Result<DateTime, ConversionError>
pub fn from_nanos(epoch_nanos: i128) -> Result<DateTime, ConversionError>
Creates a DateTime
from a number of nanoseconds since the Unix epoch.
Sourcepub fn as_nanos(&self) -> i128
pub fn as_nanos(&self) -> i128
Returns the number of nanoseconds since the Unix epoch that this DateTime
represents.
Sourcepub fn from_fractional_secs(epoch_seconds: i64, fraction: f64) -> DateTime
pub fn from_fractional_secs(epoch_seconds: i64, fraction: f64) -> DateTime
Creates a DateTime
from a number of seconds and a fractional second since the Unix epoch.
§Example
assert_eq!(
DateTime::from_secs_and_nanos(1, 500_000_000u32),
DateTime::from_fractional_secs(1, 0.5),
);
Sourcepub fn from_secs_and_nanos(seconds: i64, subsecond_nanos: u32) -> DateTime
pub fn from_secs_and_nanos(seconds: i64, subsecond_nanos: u32) -> DateTime
Creates a DateTime
from a number of seconds and sub-second nanos since the Unix epoch.
§Example
assert_eq!(
DateTime::from_fractional_secs(1, 0.5),
DateTime::from_secs_and_nanos(1, 500_000_000u32),
);
Sourcepub fn as_secs_f64(&self) -> f64
pub fn as_secs_f64(&self) -> f64
Returns the DateTime
value as an f64
representing the seconds since the Unix epoch.
Note: This conversion will lose precision due to the nature of floating point numbers.
Sourcepub fn from_secs_f64(epoch_seconds: f64) -> DateTime
pub fn from_secs_f64(epoch_seconds: f64) -> DateTime
Creates a DateTime
from an f64
representing the number of seconds since the Unix epoch.
§Example
assert_eq!(
DateTime::from_fractional_secs(1, 0.5),
DateTime::from_secs_f64(1.5),
);
Sourcepub fn from_str(s: &str, format: Format) -> Result<DateTime, DateTimeParseError>
pub fn from_str(s: &str, format: Format) -> Result<DateTime, DateTimeParseError>
Parses a DateTime
from a string using the given format
.
Sourcepub fn has_subsec_nanos(&self) -> bool
pub fn has_subsec_nanos(&self) -> bool
Returns true if sub-second nanos is greater than zero.
Sourcepub fn secs(&self) -> i64
pub fn secs(&self) -> i64
Returns the epoch seconds component of the DateTime
.
Note: this does not include the sub-second nanos.
Sourcepub fn set_seconds(&mut self, seconds: i64) -> &mut DateTime
pub fn set_seconds(&mut self, seconds: i64) -> &mut DateTime
Set the seconds component of this DateTime
.
Sourcepub fn subsec_nanos(&self) -> u32
pub fn subsec_nanos(&self) -> u32
Returns the sub-second nanos component of the DateTime
.
Note: this does not include the number of seconds since the epoch.
Sourcepub fn set_subsec_nanos(&mut self, subsec_nanos: u32) -> &mut DateTime
pub fn set_subsec_nanos(&mut self, subsec_nanos: u32) -> &mut DateTime
Set the “sub-second” nanoseconds of this DateTime
.
Sourcepub fn to_millis(self) -> Result<i64, ConversionError>
pub fn to_millis(self) -> Result<i64, ConversionError>
Converts the DateTime
to the number of milliseconds since the Unix epoch.
This is fallible since DateTime
holds more precision than an i64
, and will
return a ConversionError
for DateTime
values that can’t be converted.
Trait Implementations§
Source§impl From<SystemTime> for DateTime
impl From<SystemTime> for DateTime
Source§fn from(time: SystemTime) -> DateTime
fn from(time: SystemTime) -> DateTime
Source§impl Ord for DateTime
impl Ord for DateTime
Source§impl PartialOrd for DateTime
impl PartialOrd for DateTime
impl Copy for DateTime
impl Eq for DateTime
impl StructuralPartialEq for DateTime
Auto Trait Implementations§
impl Freeze for DateTime
impl RefUnwindSafe for DateTime
impl Send for DateTime
impl Sync for DateTime
impl Unpin for DateTime
impl UnwindSafe for DateTime
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)Source§impl<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.