Xfce Wiki

Sub domains
 

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
xfce:xfce4-panel:clock [2013/07/29 19:10] – [Label and Tooltip Markup] nickxfce:xfce4-panel:clock [2024/12/11 11:32] (current) – kevinbowen
Line 1: Line 1:
-====== Clock ======+~~NOTOC~~ 
 +{{ :xfce:xfce4-panel.png?nolink|}} 
 +====== xfce4-panel - Clock ======
  
-The //Clock// panel plugin displays the current time in a variety of styles and formats.+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.
  
-====== Properties ======+  * **[[#Time Settings|Time Settings]]** 
 +  * **[[#Appearance|Appearance]]** 
 +  * **[[#Clock Options|Clock Options]]** 
 +  * **[[#Label and Tooltip Markup|Label and Tooltip Markup]]** 
 +  * **[[#Hidden Settings|Hidden Settings]]**
  
-<figure "Clock's properties dialog"> +---- 
-{{:xfce:xfce4-panel:clock.png?nolink&|}}+ 
 +===== Preferences ===== 
 + 
 +<figure "Clock Preferences"> 
 +{{:xfce:xfce4-panel:xfce4-panel-clock.png|xfce4-panel Clock Preferences Window}}
 </figure> </figure>
  
-===== Appearance =====+----
  
-? Tooltip Format +===== Time Settings ===== 
-! Changes how the time is displayed when hovering over the clock display.  +? Timezone 
-? Show Frame +! Allows you to set a custom timezone for the clock by entering the name of a file in the zoneinfo database. If left blank, the clock uses the localtime. 
-! Displays a frame around the clock display.+ 
 +---- 
 + 
 +===== Calendar ===== 
 +? Command 
 +! Allows you to set a custom command for the calendar window instead of the default GTK calendar. A possible choice if you use [[:apps:orage:start|Orage]] is ''orage -t''. 
 + 
 +---- 
 + 
 +===== Appearance =====
 ? Layout ? Layout
-  ? Analog +    ? Analogue 
-  ! Displays time as a clock face with hands representing the current hour, minute, and seconds.  +    ! Displays a round, analogue clock with an hour, minute and optionally second hand in the panel. 
-  ? Binary +    ? Binary 
-  ! Displays a binary clock.  +    ! Displays a grid with highlighted tiles depicting the time in binary. 
-  ? Digital +    ? Digital 
-  ! A simple time display with multiple formats.  +    ! Displays the time digitally. 
-  ? Fuzzy +    ? Fuzzy 
-  ! Displays an approximation of the current time.  +    ! Displays the time as words rather than using numbers. 
-  ? LCD +    ? LCD 
-  ! Displays the time in the style of a digital LCD click.+    ! Displays the time in the style of an LCD clock. 
 + 
 +? Tooltip format 
 +! Changes the format of the time that gets displayed in the tooltip when hovering over the clock plugin. 
 + 
 +[[|Back to Top]] 
 +----
  
 ===== Clock Options ===== ===== Clock Options =====
 +The options available will vary depending on the clock {gui>Layout} selected.
  
-<note tip>The options available in //Clock Options// will vary depending on the clock {gui>Layout} selected.</note>+^ Analogue ^^  
 +| Display seconds | Displays the seconds hand on the clock face |
  
-? 24-hour Clock +^ Binary ^^  
-! Displays time in a 24-hour (military) format. ({gui>LCD} layout only.)  +| Binary mode | Decimal, Sexagesimal or Binary time, see https://en.wikipedia.org/w/index.php?title=Binary_clock&oldid=1081961926 | 
-? Display Seconds +| Display seconds | Displays seconds on the clock | 
-! Displays a seconds indicator in the clock display. ({gui>Analog}, {gui>LCD}, and {gui>Binary} layouts only.)  +| Show Inactive Dots | Show empty dots | 
-? Flash Time Seperators +| Show grid | Adds gridlines to the clock | 
-! Flash the seperators between digits. ({gui>LCD} layout only.)  + 
-? Format +^ Digital ^^  
-! Changes the time format of the clock with predefined or custom layout. ({gui>Digital} layout only.)  +| Layout | Choose the layout you want. To display time and date on the same line, use "Date only" or "Time only" and a custom format: |{{:xfce:xfce4-panel:xfce4-panel-clock-date-time-1.png?nolink&|Clock Options Preferences Window}} {{:xfce:xfce4-panel:xfce4-panel-clock-date-time-2.png?nolink&|Digital Clock Display}} | 
-? Fuzziness +| Font | The font that applies globally to the format selected below | 
-! 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. ({gui>Fuzzy} layout only.)  +| Format | Format in which time and date are displayed with a predefined or custom format. Fonts entered here take precedence over the one selected above since 4.18.1. | 
-? Show AM/PM + 
-! Displays an 'A' or 'P' to indicate the time of day. ({gui>LCD} layout only.)  +^ Fuzzy ^^  
-? Show Grid +| 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) | 
-! Adds gridlines to the clock. ({gui>Binary} layout only.)  + 
-? Show Inactive Dots +^ LCD ^^  
-! All dots that are empty are not shown in the clock display. ({gui>Binary} layout only.)  +| Display seconds | Displays a seconds indicator on the clock | 
-? True Binary Clock +| 24-hour clock | Displays time in a 24-hour (military) format | 
-! Displays a seconds indicator in the clock display. ({gui>Binary} layout only.) +| 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 | 
 + 
 +[[|Back to Top]] 
 +----
  
 ===== 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.+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://docs.gtk.org/Pango/pango_markup.html|Pango Text Attribute Markup]] manual to see what attributes are supported (e.g. font face, color etc). 
 + 
 +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-old.gnome.org/glib/stable/glib-GDateTime.html#g-date-time-format|GDateTime]]: 
 + 
 +^ 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) |  
 +| %c | locale's date and time (e.g., Thu Mar  3 23:05:25 2005) | 
 +| %C | century; like %Y, except omit last two digits (e.g., 21) | 
 +| %d | day of month (e.g, 01) | 
 +| %e | day of month, space padded; same as %_d | 
 +| %F | full date; same as %Y-%m-%d | 
 +| %g | last two digits of year of ISO week number (see %G) | 
 +| %G | year of ISO week number (see %V); normally useful only with %V | 
 +| %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 | 
 +| %p | locale's equivalent of either AM or PM; blank if not known | 
 +| %P | like %p, but lower case | 
 +| %r | locale's 12-hour clock time (e.g., 11:11:04 PM) | 
 +| %R | 24-hour hour and minute; same as %H:%M | 
 +| %s | seconds since 1970-01-01 00:00:00 UTC | 
 +| %S | second (00..60) | 
 +| %t | a tab | 
 +| %T | time; same as %H:%M:%S |  
 +| %u | day of week (1..7); 1 is Monday | 
 +| %V | ISO week number, with Monday as first day of week (01..53) | 
 +| %w | day of week (0..6); 0 is Sunday | 
 +| %x | locale's date representation (e.g., 12/31/99) | 
 +| %X | locale's time representation (e.g., 23:13:48) | 
 +| %y | last two digits of year (00..99) | 
 +| %Y | year | 
 +| %z | +hhmm numeric timezone (e.g., -0400) | 
 +| %:z | +hh:mm numeric timezone (e.g., -04:00) | 
 +| %::z |+hh:mm:ss numeric time zone (e.g., -04:00:00) | 
 +| %:::z | numeric time zone  with : to necessary precision (e.g., -04, +05:30) | 
 +| %Z | alphabetic time zone abbreviation (e.g., EDT) | 
 + 
 +By default, numeric fields are padded with 0's. The following optional flags may follow ''%'': 
 + 
 +^ Flag      ^ Meaning        ^ 
 +| O (uppercase "o") | use alternative numeric symbols, if the current locale supports those | 
 +| - (hyphen) | do not pad the field | 
 +| _ (underscore) | pad with spaces | 
 +| 0 (zero) | pad with zeros |
  
-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''):+[[|Back To Top]] 
 +----
  
-? %% +===== Hidden Settings ===== 
-! a literal % +These hidden settings can be manually created using the xfce4-settings-editor and must be created as children of the "clock" plugin. A simple one-liner can be used to create the property and is displayed below for hidden element.
-? %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) +
-? %c +
-! locale's date and time (e.g., Thu Mar  3 23:05:25 2005) +
-? %C +
-! century; like %Y, except omit last two digits (e.g., 21) +
-? %d +
-! day of month (e.g, 01) +
-? %D +
-! date; same as %m/%d/%y +
-? %e +
-! day of month, space padded; same as %_d +
-? %F +
-! full date; same as %Y-%m-%d +
-? %g +
-! last two digits of year of ISO week number (see %G) +
-? %G +
-! year of ISO week number (see %V); normally useful only with %V +
-? %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 +
-! locale's equivalent of either AM or PM; blank if not known +
-? %P +
-! like %p, but lower case +
-? %r +
-! locale's 12-hour clock time (e.g., 11:11:04 PM) +
-? %R +
-! 24-hour hour and minute; same as %H:%M +
-? %s +
-! seconds since 1970-01-01 00:00:00 UTC +
-? %S +
-! second (00..60) +
-? %t +
-! a tab +
-? %T +
-! time; same as %H:%M:%S +
-? %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) +
-? %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 time representation (e.g., 23:13:48) +
-? %y +
-! last two digits of year (00..99) +
-? %Y +
-! year +
-? %z +
-! +hhmm numeric timezone (e.g., -0400) +
-? %:z +
-! +hh:mm numeric timezone (e.g., -04:00) +
-? %::z +
-! +hh:mm:ss numeric time zone (e.g., -04:00:00) +
-? %:::z +
-! numeric time zone  with : to necessary precision (e.g., -04, +05:30) +
-? %Z +
-! alphabetic time zone abbreviation (e.g., EDT)+
  
-By default, numeric fields are padded with zeroes. The following optional flags may follow ''%'':+?time-config-tool
  
-? - (hyphen) +The default time-config-tool is "time-admin". If it is available on your system, the "Time and Date Settings" button will be enabled in clock properties. You can customize what application is used for setting data and time by setting this property.
-! do not pad the field +
-? _ (underscore) +
-! pad with spaces +
-? 0 (zero) +
-! pad with zeros +
-? ^ +
-! use upper 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.+You can use this one-liner to create the property: 
 +<code>COMMAND="APP_TO_RUN"; xfconf-query -c xfce4-panel -p $(xfconf-query -c xfce4-panel -lv | grep clock | awk '{print $1}')/time-config-tool -t string -s "$COMMAND" -n</code> 
 +Change APP_TO_RUN to the name of the custom tool that you want to use.
  
 +[[|Back To Top]]
 +----
 +[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]