From 1c5bf2468b7f0fe2aa63c6037c82521bff1dac17 Mon Sep 17 00:00:00 2001
From: Alexander von Gluck IV <kallisti5@unixzen.com>
Date: Mon, 4 Sep 2017 11:08:08 -0500
Subject: [PATCH] std/time: Give an example to get UNIX_EPOCH in seconds

---
 src/libstd/time/mod.rs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/libstd/time/mod.rs b/src/libstd/time/mod.rs
index 5b893505b34d2..e0dd8cfe62e6f 100644
--- a/src/libstd/time/mod.rs
+++ b/src/libstd/time/mod.rs
@@ -382,6 +382,17 @@ 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};
+///
+/// match SystemTime::now().duration_since(UNIX_EPOCH) {
+///     Ok(n) => println!("1970-01-01 00:00:00 UTC was {} seconds ago!", n.as_secs()),
+///     Err(_) => panic!("SystemTime before UNIX EPOCH!"),
+/// }
+/// ```
 #[stable(feature = "time2", since = "1.8.0")]
 pub const UNIX_EPOCH: SystemTime = SystemTime(time::UNIX_EPOCH);