From 9cca59e9285b16a61321143e83d4f8a7b0995205 Mon Sep 17 00:00:00 2001 From: Alexander von Gluck IV Date: Sun, 3 Sep 2017 17:11:12 -0500 Subject: [PATCH 1/3] std/time: Give an example to get UNIX_EPOCH in seconds --- src/libstd/time/mod.rs | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/libstd/time/mod.rs b/src/libstd/time/mod.rs index 5b893505b34d2..f436db4ba4cb1 100644 --- a/src/libstd/time/mod.rs +++ b/src/libstd/time/mod.rs @@ -382,6 +382,15 @@ impl fmt::Debug for SystemTime { /// [`SystemTime`] instance to represent another fixed point in time. /// /// [`SystemTime`]: ../../std/time/struct.SystemTime.html +/// +/// # Examples +/// +/// ```no_run +/// use std::time::{SystemTime,UNIX_EPOCH}; +/// +/// let now = SystemTime::now().duration_since(UNIX_EPOCH).unwrap().as_secs(); +/// println!("1970-01-01 00:00:00 UTC was {} seconds ago!", now); +/// ``` #[stable(feature = "time2", since = "1.8.0")] pub const UNIX_EPOCH: SystemTime = SystemTime(time::UNIX_EPOCH); From ea8ef48f37d75d07355f8375e626a0f9e735633f Mon Sep 17 00:00:00 2001 From: Alexander von Gluck IV Date: Mon, 4 Sep 2017 08:18:29 -0500 Subject: [PATCH 2/3] std/time: Changes per PR #44301 to increase verbosity around unwrap. --- src/libstd/time/mod.rs | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/src/libstd/time/mod.rs b/src/libstd/time/mod.rs index f436db4ba4cb1..688943952f299 100644 --- a/src/libstd/time/mod.rs +++ b/src/libstd/time/mod.rs @@ -386,10 +386,14 @@ impl fmt::Debug for SystemTime { /// # Examples /// /// ```no_run -/// use std::time::{SystemTime,UNIX_EPOCH}; +/// use std::time::{SystemTime, UNIX_EPOCH}; /// -/// let now = SystemTime::now().duration_since(UNIX_EPOCH).unwrap().as_secs(); -/// println!("1970-01-01 00:00:00 UTC was {} seconds ago!", now); +/// let now = match SystemTime::now().duration_since(UNIX_EPOCH) { +/// Ok(n) => n, +/// Err(_) => panic!("SystemTime before UNIX EPOCH!"), +/// }; +/// println!("1970-01-01 00:00:00 UTC was {} seconds ago!", now.as_secs()); + /// ``` #[stable(feature = "time2", since = "1.8.0")] pub const UNIX_EPOCH: SystemTime = SystemTime(time::UNIX_EPOCH); From ff3609c631f48b572d547fa0f662da07a45481ac Mon Sep 17 00:00:00 2001 From: Alexander von Gluck IV Date: Mon, 4 Sep 2017 08:21:04 -0500 Subject: [PATCH 3/3] std/time: Drop incorrect newline --- src/libstd/time/mod.rs | 1 - 1 file changed, 1 deletion(-) diff --git a/src/libstd/time/mod.rs b/src/libstd/time/mod.rs index 688943952f299..f0f70ac6e9eb0 100644 --- a/src/libstd/time/mod.rs +++ b/src/libstd/time/mod.rs @@ -393,7 +393,6 @@ impl fmt::Debug for SystemTime { /// Err(_) => panic!("SystemTime before UNIX EPOCH!"), /// }; /// println!("1970-01-01 00:00:00 UTC was {} seconds ago!", now.as_secs()); - /// ``` #[stable(feature = "time2", since = "1.8.0")] pub const UNIX_EPOCH: SystemTime = SystemTime(time::UNIX_EPOCH);