tztr

Timezone Translator - convert timestamps to local time.

Reads from stdin or file, auto-detects timestamp formats, and preserves the original format by default.

With Homebrew:

brew install dpep/tools/tztr

With RubyGems:

gem install tztr

echo '2026-04-03T12:00:00Z' | tztr -t America/Los_Angeles
# 2026-04-03T05:00:00-07:00

echo '15:30 UTC' | tztr -t America/New_York
# 11:30 EDT

tail -f app.log | tztr

-f, --from TZ       Input timezone (default: auto-detect)
-t, --to TZ         Output timezone (default: UTC)
-F, --format FMT    Output format: iso, short, time (default: preserve input)
-v, --version       Show version
-h, --help          Show this help

Set TZ to change the default output timezone (overridden by -t):

export TZ=America/Los_Angeles
echo '2026-04-03T12:00:00Z' | tztr
# 2026-04-03T05:00:00-07:00

• ISO 8601: 2026-04-03T12:00:00Z, 2026-04-03T12:00:00+05:30
• Date + time: 2026-04-03 12:00:00 UTC
• Time only: 15:30 UTC, 08:30:45 PDT
• Fractional seconds: 2026-04-03T12:00:00.123Z

require "tztr"

Tztr.translate("log 2026-04-03T12:00:00Z event", to: "America/Los_Angeles")
# => "log 2026-04-03T05:00:00-07:00 event"

Yes please :)

1. Fork it
2. Create your feature branch (git checkout -b my-feature)
3. Ensure the tests pass (bundle exec rspec)
4. Commit your changes (git commit -am 'awesome new feature')
5. Push your branch (git push origin my-feature)
6. Create a Pull Request