-
-
Notifications
You must be signed in to change notification settings - Fork 400
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Build out ZonedDateTime, TimeZone, and Instant
- Loading branch information
Showing
9 changed files
with
751 additions
and
104 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,93 @@ | ||
| //! An implementation of the Temporal Instant. | ||
|
|
||
| use crate::{TemporalError, TemporalResult}; | ||
|
|
||
| use num_bigint::BigInt; | ||
| use num_traits::ToPrimitive; | ||
|
|
||
| /// A Temporal Instant | ||
| #[derive(Debug, Clone)] | ||
| pub struct Instant { | ||
| pub(crate) nanos: BigInt, | ||
| } | ||
|
|
||
| // ==== Public API ==== | ||
|
|
||
| impl Instant { | ||
| /// Create a new validated `Instant`. | ||
| #[inline] | ||
| pub fn new(nanos: BigInt) -> TemporalResult<Self> { | ||
| if !is_valid_epoch_nanos(&nanos) { | ||
| return Err(TemporalError::range() | ||
| .with_message("Instant nanoseconds are not within a valid epoch range.")); | ||
| } | ||
| Ok(Self { nanos }) | ||
| } | ||
|
|
||
| /// Returns the `epochSeconds` value for this `Instant`. | ||
| #[must_use] | ||
| pub fn epoch_seconds(&self) -> f64 { | ||
| (&self.nanos / BigInt::from(1_000_000_000)) | ||
| .to_f64() | ||
| .expect("A validated Instant should be within a valid f64") | ||
| .floor() | ||
| } | ||
|
|
||
| /// Returns the `epochMilliseconds` value for this `Instant`. | ||
| #[must_use] | ||
| pub fn epoch_milliseconds(&self) -> f64 { | ||
| (&self.nanos / BigInt::from(1_000_000)) | ||
| .to_f64() | ||
| .expect("A validated Instant should be within a valid f64") | ||
| .floor() | ||
| } | ||
|
|
||
| /// Returns the `epochMicroseconds` value for this `Instant`. | ||
| #[must_use] | ||
| pub fn epoch_microseconds(&self) -> f64 { | ||
| (&self.nanos / BigInt::from(1_000)) | ||
| .to_f64() | ||
| .expect("A validated Instant should be within a valid f64") | ||
| .floor() | ||
| } | ||
|
|
||
| /// Returns the `epochNanoseconds` value for this `Instant`. | ||
| #[must_use] | ||
| pub fn epoch_nanoseconds(&self) -> f64 { | ||
| self.nanos | ||
| .to_f64() | ||
| .expect("A validated Instant should be within a valid f64") | ||
| } | ||
| } | ||
|
|
||
| /// Utility for determining if the nanos are within a valid range. | ||
| #[inline] | ||
| #[must_use] | ||
| pub(crate) fn is_valid_epoch_nanos(nanos: &BigInt) -> bool { | ||
| nanos <= &BigInt::from(crate::NS_MAX_INSTANT) && nanos >= &BigInt::from(crate::NS_MIN_INSTANT) | ||
| } | ||
|
|
||
| #[cfg(test)] | ||
| mod tests { | ||
| use crate::{instant::Instant, NS_MAX_INSTANT, NS_MIN_INSTANT}; | ||
| use num_bigint::BigInt; | ||
| use num_traits::ToPrimitive; | ||
|
|
||
| #[test] | ||
| fn max_and_minimum_instant_bounds() { | ||
| // This test is primarily to assert that the `expect` in the epoch methods is valid. | ||
| let max = BigInt::from(NS_MAX_INSTANT); | ||
| let min = BigInt::from(NS_MIN_INSTANT); | ||
| let max_instant = Instant::new(max.clone()).unwrap(); | ||
| let min_instant = Instant::new(min.clone()).unwrap(); | ||
|
|
||
| assert_eq!(max_instant.epoch_nanoseconds(), max.to_f64().unwrap()); | ||
| assert_eq!(min_instant.epoch_nanoseconds(), min.to_f64().unwrap()); | ||
|
|
||
| let max_plus_one = BigInt::from(NS_MAX_INSTANT + 1); | ||
| let min_minus_one = BigInt::from(NS_MIN_INSTANT - 1); | ||
|
|
||
| assert!(Instant::new(max_plus_one).is_err()); | ||
| assert!(Instant::new(min_minus_one).is_err()); | ||
| } | ||
| } |
Oops, something went wrong.