dtt 0.0.10

A Rust library for parsing, validating, manipulating, and formatting dates and times.
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

#![allow(missing_docs)]

// Arithmetic — date and time math, leap-year aware.

use dtt::prelude::*;

fn main() -> Result<(), AppError> {
    let dt = DateTime::parse("2024-01-31T00:00:00Z")?;
    println!("Start          : {dt}");

    println!("+ 1 day        : {}", dt.next_day()?);
    println!("- 1 day        : {}", dt.previous_day()?);
    println!("+ 7 days       : {}", dt.add_days(7)?);
    println!("+ 1 month      : {}", dt.add_months(1)?); // → Feb 29 (leap)
    println!("+ 1 year       : {}", dt.add_years(1)?);
    println!("- 1 year       : {}", dt.sub_years(1)?);

    println!("Start of week  : {}", dt.start_of_week()?);
    println!("End of week    : {}", dt.end_of_week()?);
    println!("Start of month : {}", dt.start_of_month()?);
    println!("End of month   : {}", dt.end_of_month()?);
    println!("Start of year  : {}", dt.start_of_year()?);
    println!("End of year    : {}", dt.end_of_year()?);

    let later = dt.add_days(10)?;
    let diff = later.duration_since(&dt);
    println!("Days between   : {}", diff.whole_days());

    // Mutation helpers (return a new DateTime; never mutate in place).
    let noon = dt.set_time(12, 0, 0)?;
    println!("set_time 12:00 : {noon}");

    let christmas = dt.set_date(2024, 12, 25)?;
    println!("set_date 12-25 : {christmas}");

    // `sub_months` is the symmetric counterpart to `add_months`.
    println!("- 1 month      : {}", dt.sub_months(1)?);

    // `update` rebases to the current wall-clock while preserving the
    // existing offset. Useful for "tick" loops.
    let _refreshed = dt.update()?;

    Ok(())
}