tdt 0.1.0

Time Delta Toolkit (TDT): count ticks, breakdown intervals, pretty-print elapsed/remaining time.
Documentation

โฑ 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));
}

๐Ÿ“„ License

MIT License ยฉ 2025 JD Plumbing