Skip to content

Clocks

Displays a configurable list of world clocks, the local time, and date.

Configuration

clocks:
  colors:
    rows:
      even: "lightblue"
      odd: "white"
  enabled: true
  locations:
    # From https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
    - Avignon: "Europe/Paris"
    - Barcelona: "Europe/Madrid"
    - Dubai: "Asia/Dubai"
    - New York: "America/New York"
    - Toronto: "America/Toronto"
    - UTC: "Etc/UTC"
    - Vancouver: "America/Vancouver"
  position:
    top: 4
    left: 0
    height: 1
    width: 1
  refreshInterval: 15s
  # Valid options are: alphabetical, chronological, natural
  sort: "alphabetical"

Screenshots

clocks screenshot

Attributes

Name Value
dateFormat
The format of the date strings.
Any valid Go date layout which is handled by Time.Format.
timeFormat
The fomat of the time strings.
Any valid Go time layout which is handled by Time.Format.
locations
A list of timezone for the clocks to be displayed.
Any TZ database timezone.
sort
The order in which to sort the clocks.
alphabetical, chronological, or natural.

alphabetical will sort in acending order by key.
chronological will sort in ascending order by date/time.
natural will maintain the config file ordering.

Source Code

https://github.com/wtfutil/wtf/tree/master/modules/clocks