Clock

Displays the current date and time. Clicking on the widget opens a popup with the time and a calendar.

Configuration

Type: clock

Name	Type	Default	Description
format	string	%d/%m/%Y %H:%M	Date/time format string. Pango markup is supported.
format_popup	string	%H:%M:%S	Date/time format string to display in the popup header. Pango markup is supported.
locale	string	$LC_TIME or $LANG or 'POSIX'	Locale to use (eg en_GB). Defaults to the system language (reading from env var).
orientation	'horizontal' or 'vertical' (shorthand: 'h' or 'v')	'horizontal'	Orientation of the time on the clock button.
justify	'left'', 'right', 'center', or 'fill'	'left'	Justification (alignment) of the date/time shown on the bar.

Detail on available tokens can be found here: https://docs.rs/chrono/latest/chrono/format/strftime/index.html

JSON

{
  "end": [
    {
      "type": "clock",
      "format": "%d/%m/%Y %H:%M"
    }
  ]
}

TOML

[[end]]
type = "clock"
format = "%d/%m/%Y %H:%M"

YAML

end:
  - type: "clock"
    format: "%d/%m/%Y %H:%M"

Corn

{
  end = [
    {
      type = "clock"
      format = "%d/%m/%Y %H:%M"
    }
  ]
}

Styling

Selector	Description
.clock	Clock widget button
.popup-clock	Clock popup box
.popup-clock .calendar-clock	Clock inside the popup
.popup-clock .calendar	Calendar widget inside the popup. GTK provides some OOTB styling options for this.

Information on styling the calendar can be found here.

For more information on styling, please see the styling guide.