ironbar/docs/modules/Clock.md
2023-07-03 23:20:37 +01:00

2.4 KiB

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

Screenshot of clock widget with popup open

Configuration

Type: clock

Name Type Default Description
format string %d/%m/%Y %H:%M Date/time format string.
format_popup string %H:%M:%S Date/time format string to display in the popup header.
locale string $LC_TIME or $LANG or 'POSIX' Locale to use (eg en_GB). Defaults to the system language (reading from env var).

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.

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