⏱ Time Delta Toolkit (TDT)

A Rust toolkit for working with time deltas.
Count ticks, break down elapsed time, pretty-print durations, or run a live ticking clock.

TDT is compact, exact, and designed as both a library and a CLI tool.

🚀 Install

From crates.io:

cargo install tdt

From source:

git clone https://github.com/JDPlumbing/tdt.git
cd tdt
cargo install --path .

📌 Usage

Since Epoch

tdt since --unit seconds
# → Ticks since 1970-01-01

Between Dates

tdt between --start "1997-06-15 00:00:00" --end "2025-09-14 00:00:00"
# → "28 years, 3 months, 0 days"

Until Target Date

tdt until --target "2100-01-01 00:00:00" --unit days
# → "Until 2100: 27393 days"

Live Clock

tdt clock
# → Since epoch: 1737283645s | 1737283645123ms | 1737283645123456µs

🛠 Library Usage

use chrono::Utc;
use tdt::{count_ticks, pretty_breakdown};

fn main() {
    let start = Utc::now();
    let end = start + chrono::Duration::days(42);

    println!("Ticks in hours: {}", count_ticks(Some(start), Some(end), "hours"));
    println!("Breakdown: {}", pretty_breakdown(start, Some(end), 3));
}

tdt 0.1.0