URL: https://github.com/peterbe/describetime

tl;dr: Run bunx describetime 2026-10-16T15:41:41-04:00 to see a date described in different ways.

Example output:

The purpose of this tool is to help you understand a date-time you might come across. For example, how does 2026-10-22T01:28:43.000Z compare to October 21, 2026 at 9:28:43 PM EDT? (Hint: they're the same moment in time.)

Another advantage of this tool is its ability to describe a date-time in words relative to right now. As you can see in the picture, it says 4 days ago, but it also, if it helps you, says it "more accurately" as 3 days, 22 hours, 36 minutes and 32 seconds ago.

Lastly, it prints the date-time in a bunch of different time zones. Hopefully, that can help you quickly work out the time zone arithmetic.

About the CLI itself

The code for it is here: https://github.com/peterbe/describetime

It's written in TypeScript and uses Bun as the runtime. Every release is published to npmjs.com, but it is also compiled as a native binary, which you can download here. For example, if you're on Linux, you can download describetime-linux-arm64 as a single binary file and rename it to ~/bin/describetime, and then you won't need to use bunx to download and run it.

Your email will never ever be published.

Previous:
Bun 1.4.0 made some binaries of gg2 smaller August 21, 2026 Bun
Related by category:
Benchmarking oxlint vs biome December 12, 2025 Bun
Bun vs. Go for a basic web server benchmark October 24, 2025 Bun
Testing out vite 8 on SPA: Vite 8 is 5x faster December 6, 2025 Bun
Parse a CSV file with Bun September 13, 2023 Bun
Related by keyword:
Always run biome migrate after upgrading biome August 16, 2025 Node, JavaScript, Bun
gg2 - a new CLI for helping me manage git branches August 6, 2025 JavaScript, Bun, macOS
Use vars() to send an argparse Namespace into a function in Python January 8, 2019 Python
Fastest Python datetime parser May 2, 2018 Python