mirror of
https://github.com/rad4day/Waybar.git
synced 2023-12-21 10:22:59 +01:00
174db444d6
Also fixed timezones behavior: now waybar starting with the first timezone in timezones list and falling back to timezone field only if timezones omit or has no elements.
108 lines
2.6 KiB
Markdown
108 lines
2.6 KiB
Markdown
waybar-clock(5)
|
|
|
|
# NAME
|
|
|
|
waybar - clock module
|
|
|
|
# DESCRIPTION
|
|
|
|
The *clock* module displays the current date and time.
|
|
|
|
# CONFIGURATION
|
|
|
|
*interval*: ++
|
|
typeof: integer ++
|
|
default: 60 ++
|
|
The interval in which the information gets polled.
|
|
|
|
*format*: ++
|
|
typeof: string ++
|
|
default: {:%H:%M} ++
|
|
The format, how the date and time should be displayed. ++
|
|
It uses the format of the date library. See https://howardhinnant.github.io/date/date.html#to_stream_formatting for details.
|
|
|
|
*timezone*: ++
|
|
typeof: string ++
|
|
default: inferred local timezone ++
|
|
The timezone to display the time in, e.g. America/New_York. ++
|
|
This field will be ignored if *timezones* field is set and have at least one value.
|
|
|
|
*timezones*: ++
|
|
typeof: list of strings ++
|
|
A list of timezones to use for time display, changed using the scroll wheel. ++
|
|
Use "" to represent the system's local timezone. Using %Z in the format or tooltip format is useful to track which time zone is currently displayed.
|
|
|
|
*locale*: ++
|
|
typeof: string ++
|
|
default: inferred from current locale ++
|
|
A locale to be used to display the time. Intended to render times in custom timezones with the proper language and format.
|
|
|
|
*today-format*: ++
|
|
typeof: string ++
|
|
default: <b><u>{}</u></b> ++
|
|
The format of today's date in the calendar.
|
|
|
|
*max-length*: ++
|
|
typeof: integer ++
|
|
The maximum length in character the module should display.
|
|
|
|
*min-length*: ++
|
|
typeof: integer ++
|
|
The minimum length in characters the module should take up.
|
|
|
|
*align*: ++
|
|
typeof: float ++
|
|
The alignment of the text, where 0 is left-aligned and 1 is right-aligned. If the module is rotated, it will follow the flow of the text.
|
|
|
|
*rotate*: ++
|
|
typeof: integer ++
|
|
Positive value to rotate the text label.
|
|
|
|
*on-click*: ++
|
|
typeof: string ++
|
|
Command to execute when clicked on the module.
|
|
|
|
*on-click-middle*: ++
|
|
typeof: string ++
|
|
Command to execute when middle-clicked on the module using mousewheel.
|
|
|
|
*on-click-right*: ++
|
|
typeof: string ++
|
|
Command to execute when you right clicked on the module.
|
|
|
|
*on-update*: ++
|
|
typeof: string ++
|
|
Command to execute when the module is updated.
|
|
|
|
*on-scroll-up*: ++
|
|
typeof: string ++
|
|
Command to execute when scrolling up on the module.
|
|
|
|
*on-scroll-down*: ++
|
|
typeof: string ++
|
|
Command to execute when scrolling down on the module.
|
|
|
|
*smooth-scrolling-threshold*: ++
|
|
typeof: double ++
|
|
Threshold to be used when scrolling.
|
|
|
|
View all valid format options in *strftime(3)*.
|
|
|
|
# FORMAT REPLACEMENTS
|
|
|
|
*{calendar}*: Current month calendar
|
|
|
|
# EXAMPLES
|
|
|
|
```
|
|
"clock": {
|
|
"interval": 60,
|
|
"format": "{:%H:%M}",
|
|
"max-length": 25
|
|
}
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#clock*
|