UNDERTIME(1)

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 and the current time is marked in bold. Colors are replaced by an underscore suffix and the current time by a star if colors are disabled. 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. enabled by default if output is a terminal.

--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.

undertime -s 8 -e 18 --date 2014-03-15
    Show a longer work day in march 2014.

ENVIRONMENT

TZ  Default timezone.

SEE ALSO
tzselect(8) tzfile(5)