mirror of
https://github.com/rad4day/Waybar.git
synced 2023-12-21 10:22:59 +01:00
ece86c96d7
Introducing new tooltip placeholder: {timezoned_time_list}. It will be replaced with the list of times in different time zones.
I've found it useful to hover the mouse pointer on time and see time in all my timezones at once.
Current timezone excluding from the list, so if you will scroll over the time module and change the active timezone, this timezone will be excluded from the list and the previous active zone will be added.
109 lines
2.7 KiB
Markdown
109 lines
2.7 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
|
|
*{timezoned_time_list}*: List of time in the rest timezones, if more than one timezone is set in the config
|
|
|
|
# EXAMPLES
|
|
|
|
```
|
|
"clock": {
|
|
"interval": 60,
|
|
"format": "{:%H:%M}",
|
|
"max-length": 25
|
|
}
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#clock*
|