1waybar-clock(5)               File Formats Manual              waybar-clock(5)
2
3
4

NAME

6       waybar - clock module
7

DESCRIPTION

9       The clock module displays the current date and time.
10

CONFIGURATION

12       interval:
13            typeof: integer
14            default: 60
15            The interval in which the information gets polled.
16
17       format:
18            typeof: string
19            default: {:%H:%M}
20            The format, how the date and time should be displayed.
21            It uses the format of the date library. See https://howardhin‐
22       nant.github.io/date/date.html#to_stream_formatting for details.
23
24       timezone:
25            typeof: string
26            default: inferred local timezone
27            The timezone to display the time in, e.g. America/New_York.
28
29       timezones:
30            typeof: list of strings
31            A list of timezones to use for time display, changed using the
32       scroll wheel.
33            Use "" to represent the system's local timezone.  Using %Z in the
34       format or tooltip format is useful to track which time zone is cur‐
35       rently displayed.
36
37       locale:
38            typeof: string
39            default: inferred from current locale
40            A locale to be used to display the time. Intended to render times
41       in custom timezones with the proper language and format.
42
43       today-format:
44            typeof: string
45            default: <b><u>{}</u></b>
46            The format of today's date in the calendar.
47
48       max-length:
49            typeof: integer
50            The maximum length in character the module should display.
51
52       rotate:
53            typeof: integer
54            Positive value to rotate the text label.
55
56       on-click:
57            typeof: string
58            Command to execute when clicked on the module.
59
60       on-click-middle:
61            typeof: string
62            Command to execute when middle-clicked on the module using mouse‐
63       wheel.
64
65       on-click-right:
66            typeof: string
67            Command to execute when you right clicked on the module.
68
69       on-update:
70            typeof: string
71            Command to execute when the module is updated.
72
73       on-scroll-up:
74            typeof: string
75            Command to execute when scrolling up on the module.
76
77       on-scroll-down:
78            typeof: string
79            Command to execute when scrolling down on the module.
80
81       smooth-scrolling-threshold:
82            typeof: double
83            Threshold to be used when scrolling.
84
85       View all valid format options in strftime(3).
86

FORMAT REPLACEMENTS

88       {calendar}: Current month calendar
89

EXAMPLES

91           "clock": {
92               "interval": 60,
93               "format": "{:%H:%M}",
94               "max-length": 25
95           }
96

STYLE

98       ·   #clock
99
100
101
102                                  2021-02-10                   waybar-clock(5)