clock module displays current date and time.

There are two implementations:

• clock: Full-featured implementation, including the calendar and timezone support described below. Enabled at build time when either C++20 concepts (__cpp_concepts >= 201907, gcc >= 13) are available, or the HowardHinnant date library <https://github.com/HowardHinnant/date\> is installed.

• simpleclock: Fallback that provides date and time display only. Used when the above build conditions are not met.

1. Addressed by clock

View all valid format options in strftime(3) or have a look https://en.cppreference.com/w/cpp/chrono/duration/formatter

2. Addressed by clock: calendar

3. Addressed by clock: calendar: format

• {calendar}: Current month calendar

• {tz_list}: List of time in the rest timezones, if more than one timezone is set in the config

• {ordinal_date}: The current day in (English) ordinal form, e.g. 21st

1. General

"clock": {
	"interval": 60,
	"format": "{:%H:%M}",
	"max-length": 25
}

2. Calendar

"clock": {
	"format": "{:%H:%M}  ",
	"format-alt": "{:%A, %B %d, %Y (%R)} 󰃰 ",
	"tooltip-format": "<tt><small>{calendar}</small></tt>",
	"calendar": {
		"mode"             : "year",
		"mode-mon-col"     : 3,
		"weeks-pos"        : "right",
		"first-day-of-week": 1,
		"on-scroll"        : 1,
		"on-click-right"   : "mode",
		"format": {
			"months":     "<span color='#ffead3'><b>{}</b></span>",
			"days":       "<span color='#ecc6d9'><b>{}</b></span>",
			"weeks":      "<span color='#99ffdd'><b>W{}</b></span>",
			"weekdays":   "<span color='#ffcc66'><b>{}</b></span>",
			"today":      "<span color='#ff6699'><b><u>{}</u></b></span>"
		}
	},
	"actions": {
		"on-click-right": "mode",
		"on-click-forward": "tz_up",
		"on-click-backward": "tz_down",
		"on-scroll-up": "shift_up",
		"on-scroll-down": "shift_down"
	}
},

3. Full date on hover

"clock": {
	"interval": 60,
	"tooltip": true,
	"format": "{:%H.%M}",
	"tooltip-format": "{:%Y-%m-%d}",
}

4. Show timezone in tooltip only

"clock": {
	"interval": 60,
	"format": "{:%H:%M}",
	"timezone-tooltip-format": "{:%H:%M %Z}",
	"timezones": [
		"",
		"America/Chicago",
		"America/Los_Angeles",
		"Europe/Paris",
		"UTC"
	],
	"tooltip": true,
	"tooltip-format": "{tz_list}"
}

5. Simple calendar tooltip

"clock": {
"format": "{:%H:%M}",
"tooltip-format": "<tt>{calendar}</tt>",
"calendar": {
"format": {
"today": "<span color='#ffcc66'><b>{}</b></span>"
}
}
}

• #clock

If displaying seconds causes other modules to shift side to side, the cause is usually proportional-width digits. If your font supports it, add font-feature-settings: "tnum"; to the #clock style (or wherever you set the bar font) to use fixed-width numbers.

The following classes are used only inside the {calendar} tooltip. Their foreground color is read and applied to the corresponding calendar cells in the tooltip markup:

• .calendar-today: The current day

• .calendar-days: The day numbers

• .calendar-weeks: The week numbers

• .calendar-weekdays: The weekday header (Su, Mo, ...)

• .calendar-months: The month header (January, February, ...)

If clock module is disabled at startup with locale::facet::_S_create_c_locale
name not valid error message try one of the following:

• check if LC_TIME is set properly (glibc)

• set locale to C in the config file (musl)

When using clock instead of simpleclock, the locale defaults to C regardless of the locale settings. To override this, prepend L to the format string, e.g. {:%a %m %d} becomes {:L%a %m %d}.

The locale option must be set for {calendar} to use the correct start-of-week, regardless of system locale.

In order to have aligned Chinese calendar there are some useful recommendations:

1.

Use "WenQuanYi Zen Hei Mono" which is provided in most Linux distributions

2.

Try different font sizes and find best for you. size = 9pt should be fine

3.

In case when "WenQuanYi Zen Hei Mono" font is used disable monospace font pango tag

Example of working config

"clock": {
	"format": "{:%H:%M}  ",
	"format-alt": "{:%A, %B %d, %Y (%R)} 󰃰 ",
	"tooltip-format": "n<span size='9pt' font='WenQuanYi Zen Hei Mono'>{calendar}</span>",
	"calendar": {
		"mode"          : "year",
		"mode-mon-col"  : 3,
		"weeks-pos"     : "right",
		"on-scroll"     : 1,
		"on-click-right": "mode",
		"format": {
			"months":     "<span color='#ffead3'><b>{}</b></span>",
			"days":       "<span color='#ecc6d9'><b>{}</b></span>",
			"weeks":      "<span color='#99ffdd'><b>W{}</b></span>",
			"weekdays":   "<span color='#ffcc66'><b>{}</b></span>",
			"today":      "<span color='#ff6699'><b><u>{}</u></b></span>"
		}
	},
	"actions": {
		"on-click-right": "mode",
		"on-click-forward": "tz_up",
		"on-click-backward": "tz_down",
		"on-scroll-up": "shift_up",
		"on-scroll-down": "shift_down"
	}
},