deep-time 0.1.0-beta.28

High-precision, no-std, no-alloc date-time library, leap-seconds, time scales, relativistic time, and a powerful date & duration parser
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! This example shows how precision can be controlled, in this
//! case it's by 1 minute.
//!
//! In this way you can compare two times at a given precision,
//! and also format them to a string without the seconds.
//!
//! ```text
//! cargo run --example precision_control
//! ```

use deep_time::macros::{from_sec, from_ymd};
use deep_time::{Dt, DtErr, Lang, Scale};

const ONE_MIN: Dt = from_sec!(60);

fn to_utc_and_floor(dt: Dt) -> Dt {
    dt.to(Scale::UTC).floor(ONE_MIN)
}

fn main() -> Result<(), DtErr> {
    // Noisy inputs (seconds / subseconds from a feed or clock).
    let depart = to_utc_and_floor(from_ymd!(
        2026,
        7,
        9;
        9,
        15,
        37,
        Dt::to_u64(Dt::ms_to_attos(500))
    ));
    let arrive = to_utc_and_floor(from_ymd!(2026, 7, 9; 12, 42, 11, 1));

    // Comparison at minute resolution.
    assert!(depart < arrive);
    assert_eq!(depart, to_utc_and_floor(from_ymd!(2026, 7, 9; 9, 15)));

    // Display: omit seconds with strftime-style formatting (no need for a wrapper type).
    let depart_s = depart.to_str_b("%Y-%m-%d %H:%M", Lang::En)?;
    let arrive_s = arrive.to_str_b("%Y-%m-%d %H:%M", Lang::En)?;
    assert_eq!(depart_s.as_str(), "2026-07-09 09:15");
    assert_eq!(arrive_s.as_str(), "2026-07-09 12:42");

    Ok(())
}