Xfce Wiki

Sub domains

This is an old revision of the document!


The Clock panel plugin displays the current time in a variety of styles and formats.


Clock's properties dialog


Control Element Usage
Tooltip Format Changes how the time is displayed when hovering over the clock display
Show Frame Displays a frame around the clock display
Layout Analog Displays time as a clock face with hands representing the current hour, minute, and seconds
Binary Displays a binary clock
Digital A simple time display with multiple formats
Fuzzy Displays an approximation of the current time
LCD Displays the time in the style of a digital LCD click

Clock Options

The options available in Clock Options will vary depending on the clock Layout selected.

24-hour Clock Displays time in a 24-hour (military) format
Display Seconds Displays a seconds indicator in the clock display
Flash Time Seperators Flash the seperators between digits
Show AM/PM Displays an 'A' or 'P' to indicate the time of day
Display Seconds Displays a seconds indicator in the clock display
Display Seconds Displays a seconds indicator in the clock display
Show Grid Adds gridlines to the clock
Show Inactive Dots All dots that are empty are not shown in the clock display
True Binary Clock Displays a seconds indicator in the clock display
Format Changes the time format of the clock with predefined or custom layout
Fuzziness Changes the degree of 'fuzziness' that the clock will display. 0 being the most accurate, 1 being less accurate, and 2 being the least accurate

Label and Tooltip Markup

The plugin supports markup to change the layout of the tooltip and the label on the panel. Consult the Text Attribute Markup manual of Pango so see what attributes are supported. As an example you can have the following custom format:

%R%n<span size='x-small'>%d-%m w%V</span>

Additionally %n for new-lines and %t for tabs are also supported.

The following is a list of available label format control sequences copied from a date utility manual (man date):

Symbol Meaning
%% a literal %
%a locale's abbreviated weekday name (e.g., Sun)
%A locale's full weekday name (e.g., Sunday)
%b locale's abbreviated month name (e.g., Jan)
%B locale's full month name (e.g., January)
%d day of month (e.g, 01)
%h same as %b
%H hour (00..23)
%I hour (01..12)
%j day of year (001..366)
%k hour ( 0..23)
%l hour ( 1..12)
%m month (01..12)
%M minute (00..59)
%n a newline
%N nanoseconds (000000000..999999999)
%P like %p, but lower case
%S second (00..60)
%t a tab
%Y year
%Z alphabetic time zone abbreviation (e.g., EDT)

By default, numeric fields are padded with zeroes. The following optional flags may follow %:

Flag Meaning
- (hyphen) do not pad the field
_ (underscore) pad with spaces
0 (zero) pad with zeros
^ use upper case if possible
# use opposite case if possible
