datefmt(1)

🌸 datefmt(1) — format timestamps in text streams 🌸

ok so bestie. datefmt is a General Commands Manual girlie and she's literally here to make ur log files cute. Let me tell u everything 💅

✨ NAME ✨

datefmt — format timestamps in text streams 🎀

✨ SYNPOSIS ✨

like, here's the whole vibe of how u call her:

datefmt [--after timestamp] [--before timestamp] [--past] [--future]
[--version] [--ms]

🦋 DESCRIPTION 🦋

okay so picture this: datefmt is a tool that formats timestamps in text streams. no cap, that's the whole thing.

like, say you've got a log file with unix timestamps in it (ugh, raw numbers, not the vibe 😭). you literally just pipe it to datefmt and she converts those timestamps into formatted dates. that's it. that's the magic. she ate and left no crumbs 💖

👑 OPTIONS 👑

every single flag, laid out like a little menu. pick ur faves 🍓

• -a, --after <timestamp> — only format timestamps after this date (default: 2000-01-01Z). so anything older gets left alone, respectfully 🙈
• -b, --before <timestamp> — only format timestamps before this date
• -p, --past — only format timestamps in the past
• -f, --future — only format timestamps in the future
• -m, --ms — interpret timestamps as milliseconds instead of seconds. tiny units, big energy ⭐
• -r, --relative — relative timestamp formatting
• --version — display version and exit. short and sweet, she's iconic like that 🫶

🌈 FORMAT 🌈

a strftime(3) format string, bestie. it defaults to '%F %R' — that's the default look, and honestly it's serving 💅

and!!! the default can be changed with the DEFAULT_DATEFMT environment variable. so u can customize her whole aesthetic, iykyk ✨

💜 EXAMPLE 💜

here's a real one, copy it, live it, love it:

datefmt --after $(date -d yesterday +%s) %R < log.txt

see what she did there? --after + yesterday's timestamp + a %R format, all streamed in from log.txt. chef's kiss 🔥

---

ok so quick lil PSA reminder: -a/--after has a default of 2000-01-01Z, so if u don't pass it, that's the line in the sand. don't get caught out 💀

and that's the whole page, bestie! 🧚 this gorgeous little manual is datefmt(1) from the source/version dated 1980-01-01 — yeah she's vintage AND she's thriving, main character energy fr fr. mwah 💋🌸