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 [2019/12/09 08:00] – kevinbowenxfce:xfce4-panel:clock [2024/12/11 11:32] (current) – kevinbowen
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
-{{ :xfce:xfce4-panel:xfce4-panel.png?nolink|}} +{{ :xfce:xfce4-panel.png?nolink|}} 
-====== Clock ======+====== xfce4-panel - Clock ======
  
 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.
Line 9: Line 9:
   * **[[#Clock Options|Clock Options]]**   * **[[#Clock Options|Clock Options]]**
   * **[[#Label and Tooltip Markup|Label and Tooltip Markup]]**   * **[[#Label and Tooltip Markup|Label and Tooltip Markup]]**
 +  * **[[#Hidden Settings|Hidden Settings]]**
  
 ---- ----
Line 14: Line 15:
 ===== Preferences ===== ===== Preferences =====
  
-<figure "Clock Preferences">{{:xfce:xfce4-panel:xfce4-panel-clock.png?nolink&|}}</figure>+<figure "Clock Preferences"> 
 +{{:xfce:xfce4-panel:xfce4-panel-clock.png|xfce4-panel Clock Preferences Window}} 
 +</figure>
  
 ---- ----
Line 21: Line 24:
 ? Timezone ? Timezone
 ! 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. ! 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.
 +
 +----
 +
 +===== 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''.
  
 ---- ----
Line 50: Line 59:
  
 ^ Binary ^^  ^ Binary ^^ 
 +| Binary mode | Decimal, Sexagesimal or Binary time, see https://en.wikipedia.org/w/index.php?title=Binary_clock&oldid=1081961926 |
 | Display seconds | Displays seconds on the clock | | Display seconds | Displays seconds on the clock |
-| True binary clock | Enlarges the grid and displays 2 / 3 rows rather than 4 | 
 | Show Inactive Dots | Show empty dots | | Show Inactive Dots | Show empty dots |
 | Show grid | Adds gridlines to the clock | | Show grid | Adds gridlines to the clock |
  
 ^ Digital ^^  ^ Digital ^^ 
-| Format | Changes the format in which the time is displayed with a predefined or custom format |+| 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}} | 
 +| Font | The font that applies globally to the format selected below | 
 +| 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. |
  
 ^ Fuzzy ^^  ^ Fuzzy ^^ 
Line 72: Line 83:
 ===== 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. 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.+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.gnome.org/glib/stable/glib-GDateTime.html#g-date-time-format|GDateTime]]:+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        ^ ^ Symbol      ^ Meaning        ^
Line 122: Line 133:
  
 ^ Flag      ^ Meaning        ^ ^ Flag      ^ Meaning        ^
 +| O (uppercase "o") | use alternative numeric symbols, if the current locale supports those |
 | - (hyphen) | do not pad the field | | - (hyphen) | do not pad the field |
 | _ (underscore) | pad with spaces | | _ (underscore) | pad with spaces |
 | 0 (zero) | pad with zeros | | 0 (zero) | pad with zeros |
-| <nowiki>^</nowiki> | 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). 
  
 [[|Back To Top]] [[|Back To Top]]
 ---- ----
-[[ :xfce:xfce4-panel:start:|Return to Main Xfce4-panel page]]+ 
 +===== Hidden Settings ===== 
 +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. 
 + 
 +?time-config-tool 
 + 
 +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. 
 + 
 +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]]