Doc <3 for Timestamp

Author: uint

packages/std/src/timestamp.rs

@@ -7,6 +7,21 @@ use crate::math::Uint64;
 /// A point in time in nanosecond precision.
 ///
 /// This type can represent times from 1970-01-01T00:00:00Z to 2554-07-21T23:34:33Z.
+///
+/// ## Examples
+///
+/// ```
+/// # use cosmwasm_std::Timestamp;
+/// let ts = Timestamp::from_nanos(1_000_000_202);
+/// assert_eq!(ts.nanos(), 1_000_000_202);
+/// assert_eq!(ts.seconds(), 1);
+/// assert_eq!(ts.subsec_nanos(), (202));
+///
+/// let ts = ts.plus_seconds(2);
+/// assert_eq!(ts.nanos(), 3_000_000_202);
+/// assert_eq!(ts.seconds(), 3);
+/// assert_eq!(ts.subsec_nanos(), (202));
+/// ```
 #[derive(
     Serialize, Deserialize, Copy, Clone, Default, Debug, PartialEq, Eq, PartialOrd, Ord, JsonSchema,
 )]
@@ -53,7 +68,8 @@ impl Timestamp {
         self.0.u64() / 1_000_000_000
     }
 
-    /// Returns seconds since epoch (truncate nanoseconds)
+    /// Returns nanoseconds since the last whole second (the remainder truncated
+    /// by `seconds()`)
     #[inline]
     pub fn subsec_nanos(&self) -> u64 {
         self.0.u64() % 1_000_000_000