Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
xfce:xfce4-panel:clock [2019/04/11 18:31]
blueberrybrownie [Time Settings]
xfce:xfce4-panel:clock [2019/09/01 21:54] (current)
andreldm [Label and Tooltip Markup] Update pango markup link
Line 3: Line 3:
 The Clock panel plugin displays the current time in a variety of styles and formats, and allows for custom tooltips to appear on hover. It also provides a basic calendar that appears when clicked. The Clock panel plugin displays the current time in a variety of styles and formats, and allows for custom tooltips to appear on hover. It also provides a basic calendar that appears when clicked.
  
-====== Preferences ​======+===== Preferences =====
  
 <figure "Clock Preferences">​{{:​xfce:​xfce4-panel:​xfce4-panel-clock.png?​nolink&​|}}</​figure>​ <figure "Clock Preferences">​{{:​xfce:​xfce4-panel:​xfce4-panel-clock.png?​nolink&​|}}</​figure>​
Line 20: Line 20:
     ! Displays the time digitally.     ! Displays the time digitally.
     ? Fuzzy     ? Fuzzy
-    ! Displays the time as words rather than using numbers. The approximation (fuzziness) of this can be adjusted, from accurate (such as "​15:​01"​),​ to approximate (such as "​Afternoon"​).+    ! Displays the time as words rather than using numbers.
     ? LCD     ? LCD
     ! Displays the time in the style of an LCD clock.     ! Displays the time in the style of an LCD clock.
Line 28: Line 28:
  
 ===== Clock Options ===== ===== Clock Options =====
 +The options available will vary depending on the clock {gui>​Layout} selected.
  
-The options available in //Clock Options// will vary depending on the clock {gui>​Layout} selected. +Analogue ​^^  
- +| Display seconds | Displays the seconds ​hand on the clock face |
-LCD ^^  +
-| 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  | +
- +
-^ Analog ^^  +
-| Display Seconds | Displays a seconds ​indicator in the clock display ​|+
  
 ^ Binary ^^  ^ Binary ^^ 
-| Display ​Seconds ​| Displays ​seconds ​indicator in the clock display  ​+| Display ​seconds ​| Displays seconds ​on the clock | 
-Show Grid Adds gridlines to the clock +True binary clock Enlarges ​the grid and displays 2 / 3 rows rather than 4 
-| Show Inactive Dots | All dots that are empty are not shown in the clock display ​+| Show Inactive Dots | Show empty dots | 
-True Binary Clock Displays a seconds indicator in the clock display ​|+Show grid Adds gridlines to the clock |
  
 ^ Digital ^^  ^ Digital ^^ 
-| Format | Changes the time format ​of the clock with predefined or custom ​layout ​|+| Format | Changes the format ​in which the time is displayed ​with predefined or custom ​format ​|
  
 ^ Fuzzy ^^  ^ Fuzzy ^^ 
-| 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 |+| Fuzziness | Changes the degree of '​fuzziness'​ that the clock will display. 0 being the most accurate ​(displaying "six o'​clock"​ for example), 1 being less accurate, and 2 being the least accurate ​(displaying "​Afternoon"​ for example) | 
 + 
 +^ LCD ^^  
 +| Display seconds | Displays a seconds indicator on the clock | 
 +| 24-hour clock | Displays time in a 24-hour (military) format | 
 +| Flash time separators | Flash the separators between digits every second | 
 +| Show AM/PM | Displays an '​A'​ or '​P'​ next to the time to indicate the time of day |
  
 ===== Label and Tooltip Markup ===== ===== Label and Tooltip Markup =====
  
-The plugin supports markup to change the layout of the tooltip and the label on the panel. ​Consult ​the [[http://​developer.gnome.org/​pango/​stable/​PangoMarkupFormat.html|Text Attribute Markup]] manual ​of Pango so see what attributes are supported. As an example you can have the following custom format: +The plugin supports markup to change the layout of the tooltip and the label on the panel. ​For more information on Pango, the markup used for the label, see the [[https://​developer.gnome.org/​pango/​stable/​pango-Markup.html|Pango Text Attribute Markup]] manual ​to see what attributes are supported.
- +
-<​code>​%R%n%d-%m w%V</​code>​ +
- +
-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''​):​+The following is a list of available label format control sequences copied from a ''​date''​ utility manual (''​man date''​), reduced by those that are not supported by [[https://​developer.gnome.org/​glib/​stable/​glib-GDateTime.html#​g-date-time-format|GDateTime]]:
  
 ^ Symbol ​     ^ Meaning ​       ^ ^ Symbol ​     ^ Meaning ​       ^
Line 71: Line 66:
 | %C | century; like %Y, except omit last two digits (e.g., 21) | | %C | century; like %Y, except omit last two digits (e.g., 21) |
 | %d | day of month (e.g, 01) | | %d | day of month (e.g, 01) |
-| %D | date; same as %m/%d/%y | 
 | %e | day of month, space padded; same as %_d | | %e | day of month, space padded; same as %_d |
 | %F | full date; same as %Y-%m-%d | | %F | full date; same as %Y-%m-%d |
Line 85: Line 79:
 | %M | minute (00..59) | | %M | minute (00..59) |
 | %n | a newline | | %n | a newline |
-| %N | nanoseconds (000000000..999999999) | 
 | %p | locale'​s equivalent of either AM or PM; blank if not known | | %p | locale'​s equivalent of either AM or PM; blank if not known |
 | %P | like %p, but lower case | | %P | like %p, but lower case |
Line 95: Line 88:
 | %T | time; same as %H:%M:%S |  | %T | time; same as %H:%M:%S | 
 | %u | day of week (1..7); 1 is Monday | | %u | day of week (1..7); 1 is Monday |
-| %U | week number of year, with Sunday as first day of week (00..53) |  
 | %V | ISO week number, with Monday as first day of week (01..53) | | %V | ISO week number, with Monday as first day of week (01..53) |
 | %w | day of week (0..6); 0 is Sunday | | %w | day of week (0..6); 0 is Sunday |
-| %W | week number of year, with Monday as first day of week (00..53) | 
 | %x | locale'​s date representation (e.g., 12/31/99) | | %x | locale'​s date representation (e.g., 12/31/99) |
 | %X | locale'​s time representation (e.g., 23:13:48) | | %X | locale'​s time representation (e.g., 23:13:48) |
Line 109: Line 100:
 | %Z | alphabetic time zone abbreviation (e.g., EDT) | | %Z | alphabetic time zone abbreviation (e.g., EDT) |
  
-By default, numeric fields are padded with zeroes. The following optional flags may follow ''​%'':​+By default, numeric fields are padded with 0's. The following optional flags may follow ''​%'':​
  
 ^ Flag      ^ Meaning ​       ^ ^ Flag      ^ Meaning ​       ^
Line 118: Line 109:
 | # | use opposite case if possible | | # | use opposite case if possible |
  
-After any flags comes an optional field width, as a decimal number; then an optional modifier, which is either ''​E''​ to use the locale'​s alternate representations if available, or ''​O''​ to use the locale'​s alternate numeric symbols if available.+After any flags comes an optional field width, as a decimal number; then an optional modifier, which is either ''​E'' ​(to use the locale'​s alternate representations if available), or ''​O'' ​(to use the locale'​s alternate numeric symbols if available).