Bttf is a command line datetime Swiss army knife

bttf

A command line tool for datetime arithmetic, parsing, formatting and more.

Dual-licensed under MIT or the UNLICENSE.

Documentation

The user guide should be your first stop for understanding the high level concepts that bttf deals with. Otherwise, consult bttf --help or bttf <sub-command> --help for more specific details.

Alternatively, there is a comparison between other similar tools that might give you a quick sense of what bttf is like.

Brief Examples

Print the current time:

$ bttf Sat, May 10, 2025, 8:02:04 AM EDT

Tip If you get output like 2025 M05 10, Mon 08:02:04 instead, that's because you likely don't have locale support support configured. That requires setting BTTF_LOCALE and using a GitHub release binary or building bttf with the locale feature enabled.

... continue reading