1 unstable release

0.4.0 Dec 11, 2021

#34 in #day


Used in when-cli

Apache-2.0

290KB
971 lines

when

when is a small utility which tells you what time it is somewhere or what some time is somewhere.

example

Installation

Conveniently via cargo:

$ cargo install when-cli

There is also an online version you can use from your browser.

Examples

These are some other things you can do:

$ when "now"
$ when "2 hours ago in yyz"
$ when "5pm in yyz -> sfo"
$ when "5pm in vienna -> london"
$ when "4pm on 17.05.2021 in vienna -> tokyo"
$ when "4pm yesterday in vienna -> vienna va"
$ when "in 4 hours in san francisco"
$ when "2pm in 2 days in new delhi
$ when "now in yyz -> sfo -> vie -> lhr"
$ when "unix 1639067620 in tokyo"

Usage

Basically takes a single argument which is a string which describes the format in roughly this syntax. Both locations are optional. The "local" location always refers to the current machine's timezone.

time and date in location -> other location

Multiple locations can be suplied by using the arrow operator multiple times. This means you can do things like now in yyz -> sfo -> vie.

Time and date can be provided roughly like this:

  • 2:30pm, 14:30, 7:00, now
  • 14:30 tomorrow
  • 14:30
  • 17:00 on 20.05. (DD.MM.)
  • 17:00 on 20.05.2020 (DD.MM.YYYY)
  • relative times (in 4 hours or 4 hours ago)
  • unix timestamps (unix:TS or unix TS)

For locations many major cities are supported as well as common timezone names like Europe/Vienna.

Dependencies

~4–33MB
~451K SLoC