NAME

       undertime - pick a meeting time

SYNOPSIS

       undertime      [--start      HOUR]      [--end     HOUR]     [--date     WHEN]     [--colors|--no-colors]
       [--default-zone--no-default-zone] [timezones]
       undertime --print-zones

DESCRIPTION

       undertime is a program that allows you to quickly pick a  meeting  time  across  multiple  timezones  for
       conference  calls  or  other  coordinated events. It shows all times of a given day for all the timezones
       selected, in a table that aligns the time so a line shows simultaneous times across all  timezones.  This
       takes into account daylight savings and other peculiarities (provided that the local timezone database is
       up to date) so you can also schedule meetings in the future as well.

       An  educated  guess is made to find the relevant timezones: the local timezone is first guessed and added
       to the list, then the arguments on the commandline are looked  up  in  the  internal  timezone  database.
       Spaces  in  arguments are replaced by underscores and all-caps versions of lowercase strings are tried as
       well. When failing to match a provided timezone against the  internal  list,  a  warning  is  emitted.  A
       complete list of timezones is shown when the --print-zones commandline option is provided.

       Colors  are used to highlight the "work hours" where possible meeting times could overlap. You can change
       those work hours with the --start and --end flags. Because daylight savings may actually change time, you
       can also use the --date time to pick an arbitrary time for the meeting, using natural language (as parsed
       by the parsedatetime library). The current time is also shown, in bold.

OPTIONS

       --start HOUR, -s HOUR
              start of working day, in hours

       --end HOUR, -e HOUR
              end of working day, in hours

       --date WHEN, -d WHEN
              target date for the meeting, supports arbitrary dates like "in two weeks"

       --colors, --no-colors
              show colors

       --default-zone, --no-default-zone
              show current timezone first

       --print-zones
              show valid timezones and exit

       -h, --help
              Show summary of options and defaults

EXAMPLES

       undertime  "New York" "Los Angeles" Paris
              Display possible meeting times for three major cities.

ENVIRONMENT

       TZ     Default timezone.

SEE ALSO

       tzselect(8) tzfile(5)
       Timezones list ⟨https://en.wikipedia.org/wiki/List_of_tz_database_time_zones⟩
       parsedatetime Python package ⟨https://pypi.python.org/pypi/parsedatetime/⟩

                                                      2018                                          UNDERTIME(1)