std/time: Give an example to get UNIX_EPOCH in seconds

This commit is contained in:
Alexander von Gluck IV 2017-09-04 11:08:08 -05:00
parent 088216fb99
commit 1c5bf2468b

View File

@ -382,6 +382,17 @@ fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
/// [`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);