From 7e2f2e0bea68362ce5deb19fc261a6d30ae2f7f8 Mon Sep 17 00:00:00 2001 From: Jordan Petridis Date: Fri, 29 Sep 2017 19:24:40 +0300 Subject: [PATCH 1/3] Added examples/doctests for how to get a datetime from an epoch and vice versa. --- src/lib.rs | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/src/lib.rs b/src/lib.rs index 6a66e24..f733d63 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -299,6 +299,20 @@ //! [`DateTime.timestamp_subsec_nanos`](./struct.DateTime.html#method.timestamp_subsec_nanos) //! to get the number of additional number of nanoseconds. //! +//! ```rust +//! use chrono::DateTime; +//! use chrono::Utc; +//! // We need the trait in scope to use Utc::timestamp(). +//! use chrono::TimeZone; +//! +//! // Construct a datetime from epoch: +//! let dt = Utc.timestamp(1500000000, 0); +//! assert_eq!(dt.to_rfc2822(), "Fri, 14 Jul 2017 02:40:00 +0000"); +//! +//! // from a datetime: +//! let dt = DateTime::parse_from_rfc2822("Fri, 14 Jul 2017 02:40:00 +0000").unwrap(); +//! assert_eq!(dt.timestamp(), 1500000000); +//! ``` //! ### Individual date //! //! Chrono also provides an individual date type ([**`Date`**](./struct.Date.html)). From 532c025a7705ac07d6e567305c15e09cc5705d14 Mon Sep 17 00:00:00 2001 From: Jordan Petridis Date: Mon, 9 Oct 2017 02:03:18 +0300 Subject: [PATCH 2/3] Minor doc wording changes. --- src/lib.rs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/lib.rs b/src/lib.rs index f733d63..db404d2 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -300,8 +300,8 @@ //! to get the number of additional number of nanoseconds. //! //! ```rust -//! use chrono::DateTime; -//! use chrono::Utc; +//! # use chrono::DateTime; +//! # use chrono::Utc; //! // We need the trait in scope to use Utc::timestamp(). //! use chrono::TimeZone; //! @@ -309,7 +309,7 @@ //! let dt = Utc.timestamp(1500000000, 0); //! assert_eq!(dt.to_rfc2822(), "Fri, 14 Jul 2017 02:40:00 +0000"); //! -//! // from a datetime: +//! // Get epoch value from a datetime: //! let dt = DateTime::parse_from_rfc2822("Fri, 14 Jul 2017 02:40:00 +0000").unwrap(); //! assert_eq!(dt.timestamp(), 1500000000); //! ``` From 57c98a409e8b9eac534d5526495fb80325ed8c9a Mon Sep 17 00:00:00 2001 From: Jordan Petridis Date: Mon, 9 Oct 2017 14:47:07 +0300 Subject: [PATCH 3/3] Added underscores on long numbers. --- src/lib.rs | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/lib.rs b/src/lib.rs index db404d2..0f1b7ce 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -306,13 +306,14 @@ //! use chrono::TimeZone; //! //! // Construct a datetime from epoch: -//! let dt = Utc.timestamp(1500000000, 0); +//! let dt = Utc.timestamp(1_500_000_000, 0); //! assert_eq!(dt.to_rfc2822(), "Fri, 14 Jul 2017 02:40:00 +0000"); //! //! // Get epoch value from a datetime: //! let dt = DateTime::parse_from_rfc2822("Fri, 14 Jul 2017 02:40:00 +0000").unwrap(); -//! assert_eq!(dt.timestamp(), 1500000000); +//! assert_eq!(dt.timestamp(), 1_500_000_000); //! ``` +//! //! ### Individual date //! //! Chrono also provides an individual date type ([**`Date`**](./struct.Date.html)).