#time #cli

app rti

A tool to convert to/from unix epoch times

5 releases

0.1.4 May 11, 2022
0.1.3 May 11, 2022
0.1.2 Apr 22, 2022
0.1.1 Apr 22, 2022
0.1.0 Apr 22, 2022

#1032 in Command line utilities

32 downloads per month

MIT license

521 lines


RTI (Rusty Time Interpreter) is command line tool for converting between unix epoch time and date/time strings. It is written and Rust and should run on any platform.

This tool was inspired by the extremely useful epoch-echo by Ainsley Mcgrath. While the tool is fantastic and has more functionality than RTI currently, the main issues were speed and portability which inspired me to write this in Rust.


Currently you can either clone the repo and compile binaries yourself, or download with cargo. Using cargo:

cargo install rti

This will create a globally executable command that can be used in your command line. Note: This has only been tested on macOS.


RTI takes in an arbitrary number of command line arguments, either integer unix epochs or string date/time/datetimes and converts them to the opposite.

$ rti 1 1650627609 2022-04-22\ 11:40:09
1 => 01-01-1970 00:00:01
1650627609 => 04-22-2022 11:40:09
2022-04-22 11:40:09 => 1650627609
Timezone: UTC

There are also special keywords for now, yesterday, tomorrow which will give the epoch time for the current time of today, yesterday, and tomorrow respectively.

// ran at May 10, 2022 at 5:25PM UTC time
$ rti now yesterday tomorrow
now => 1652203517
yesterday => 1652117117
tomorrow => 1652289917
Timezone: UTC


RTI supports using custom timezone both by setting a persisted configuration and through environment variables. If no timezone is set in your local config or by environment variable, UTC will be used.

// Set custom timezone in config
$ rti set-tz America/New_York

// clear timezone config
$ rti clear-tz

// using TIMEZONE environment variable
$ TIMEZONE=America/Denver rti now

RTI timezones are set in the following precedence:

  1. Environment variable
  2. Config
  3. UTC if no config or Env variable is present

Custom Parsing Tokens

RTI comes with preset parsing patterns, but you can also add your own datetime tokens to parse. Note that the tokens must be full datetime values (not just time or just date).

See https://docs.rs/chrono/0.4.0/chrono/format/strftime/index.html for details on the syntax.

$ rti add-token "%d-%m-%y %H:%M"
Custom Token added

$ rti view-tokens
Custom datetime tokens:
%d-%m-%y %H:%M

$ rti remove-token "%d-%m-%y %H:%M"
Token removed if it existed: %d-%m-%y %H:%M

Limitations (Planned Features)

Currently RTI does not have support for the following (but are planned to be added over time):

  • Copy output to clipboard


~74K SLoC