TARDIS CLI (td)

TARDIS -- Time And Relative Date Input Simplifier. Like the Doctor's ship in Doctor Who, it translates human-friendly time expressions into precise datetimes right from your terminal.

$ td "next friday at 3pm"
2025-01-17T15:00:00

$ td "2 days ago" -f "%Y-%m-%d"
2025-01-13

Install

cargo install tardis-cli --locked

From source:

git clone https://github.com/hvpaiva/tardis-cli.git
cd tardis-cli && cargo install --path . --locked

Shell completions:

td completions bash > ~/.local/share/bash-completion/completions/td
td completions zsh  > "${fpath[1]}/_td"
td completions fish > ~/.config/fish/completions/td.fish

Quick Start

$ td "tomorrow 15:00"
2025-01-16T15:00:00

$ td "in 2 hours" -f "%H:%M"
12:30

$ td @1735689600 -f "%Y-%m-%d"
2025-01-01

$ td "now + 3h"
2025-01-15T13:30:00

$ td eod
2025-01-15T23:59:59

$ td "today" --json --now "2025-01-15T00:00:00Z"
{"epoch":1736899200,"format":"%Y-%m-%dT%H:%M:%S","input":"today","output":"2025-01-15T00:00:00","timezone":"UTC"}

Features

Subcommands

See the Subcommand Reference for full usage and examples.

Documentation

• Expression Reference -- All supported date/time expressions
• Subcommand Reference -- Complete subcommand documentation
• Format Specifiers -- strftime/strptime format reference
• Configuration -- Config file, environment variables, precedence

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT

Trivia

The name TARDIS pays homage to the iconic, bigger-on-the-inside time machine from Doctor Who. This CLI helps you navigate time too -- minus the wibbly-wobbly stuff.