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
Next revisionBoth sides next revision
xfce:xfce4-panel:clock [2013/07/29 19:15] – [Label and Tooltip Markup] nickxfce:xfce4-panel:clock [2019/04/11 18:22] – [Preferences] blueberrybrownie
Line 1: Line 1:
 ====== Clock ====== ====== 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 ======+====== Preferences ======
  
-<figure "Clock's properties dialog"> +<figure "Clock Preferences">{{:xfce:xfce4-panel:xfce4-panel-clock.png?nolink&|}}</figure>
-{{:xfce:xfce4-panel:clock.png?nolink&|}} +
-</figure>+
  
 +===== Time Settings =====
 +? 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.
 ===== Appearance ===== ===== Appearance =====
  
-? Tooltip Format +^ Control Element ^^ Usage ^  
-! Changes how the time is displayed when hovering over the clock display.  +| Tooltip Format | | Changes how the time is displayed when hovering over the clock display |  
-? Show Frame +| Show Frame | | Displays a frame around the clock display | 
-! Displays a frame around the clock display. +| Layout | Analog | Displays time as a clock face with hands representing the current hour, minute, and seconds | 
-? Layout +| | Binary | Displays a binary clock | 
-  ? Analog +| | Digital | A simple time display with multiple formats |  
-  ! Displays time as a clock face with hands representing the current hour, minute, and seconds.  +| | Fuzzy | Displays an approximation of the current time | 
-  ? Binary +| | LCD | Displays the time in the style of a digital LCD click |
-  ! 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 ===== ===== Clock Options =====
  
-<note tip>The options available in //Clock Options// will vary depending on the clock {gui>Layout} selected.</note>+The options available in //Clock Options// will vary depending on the clock {gui>Layout} selected.
  
-? 24-hour Clock +^ LCD ^^  
-! Displays time in a 24-hour (military) format. ({gui>LCD} layout only.)  +| 24-hour Clock | Displays time in a 24-hour (military) format | 
-? Display Seconds +| Display Seconds | Displays a seconds indicator in the clock display | 
-! Displays a seconds indicator in the clock display. ({gui>Analog}, {gui>LCD}, and {gui>Binary} layouts only.)  +| Flash Time Seperators | Flash the seperators between digits | 
-? Flash Time Seperators +| Show AM/PM | Displays an 'A' or 'P' to indicate the time of day  | 
-! Flash the seperators between digits. ({gui>LCD} layout only.)  + 
-? Format +^ Analog ^^  
-! Changes the time format of the clock with predefined or custom layout. ({gui>Digital} layout only.)  +| Display Seconds | Displays a seconds indicator in the clock display | 
-? 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. ({gui>Fuzzy} layout only.)  +^ Binary ^^  
-? Show AM/PM +| Display Seconds | Displays a seconds indicator in the clock display  | 
-! Displays an 'A' or 'P' to indicate the time of day. ({gui>LCD} layout only.)  +| Show Grid | Adds gridlines to the clock | 
-? Show Grid +| Show Inactive Dots | All dots that are empty are not shown in the clock display | 
-! Adds gridlines to the clock. ({gui>Binary} layout only.)  +| True Binary Clock | Displays a seconds indicator in the clock display | 
-? Show Inactive Dots + 
-! All dots that are empty are not shown in the clock display. ({gui>Binary} layout only.)  +^ Digital ^^  
-? True Binary Clock +| Format | Changes the time format of the clock with predefined or custom layout | 
-! Displays a seconds indicator in the clock display. ({gui>Binary} layout only.) + 
 +^ 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 |
  
 ===== Label and Tooltip Markup ===== ===== Label and Tooltip Markup =====
Line 54: Line 50:
 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. 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:
  
-  %R%n<span size='x-small'>%d-%m w%V</span>+<code>%R%n%d-%m w%V</code>
  
 Additionally ''%n'' for new-lines and ''%t'' for tabs are also supported. Additionally ''%n'' for new-lines and ''%t'' for tabs are also supported.
Line 60: Line 56:
 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''):
  
-? %% +^ Symbol      ^ Meaning        ^ 
-! a literal % +| %% | a literal % | 
-? %a +| %a | locale's abbreviated weekday name (e.g., Sun) | 
-! locale's abbreviated weekday name (e.g., Sun) +| %A | locale's full weekday name (e.g., Sunday) |  
-? %A +| %b | locale's abbreviated month name (e.g., Jan) |  
-! locale's full weekday name (e.g., Sunday) +| %B | locale's full month name (e.g., January) |  
-? %b +| %c | locale's date and time (e.g., Thu Mar  3 23:05:25 2005) | 
-! locale's abbreviated month name (e.g., Jan) +| %C | century; like %Y, except omit last two digits (e.g., 21) | 
-? %B +| %d | day of month (e.g, 01) | 
-! locale's full month name (e.g., January) +| %D | date; same as %m/%d/%y | 
-? %c +| %e | day of month, space padded; same as %_d | 
-! locale's date and time (e.g., Thu Mar  3 23:05:25 2005) +| %F | full date; same as %Y-%m-%d | 
-? %C +| %g | last two digits of year of ISO week number (see %G) | 
-! century; like %Y, except omit last two digits (e.g., 21) +| %G | year of ISO week number (see %V); normally useful only with %V | 
-? %d +| %h | same as %b | 
-! day of month (e.g, 01) +| %H | hour (00..23) | 
-? %D +| %I | hour (01..12) | 
-! date; same as %m/%d/%y +| %j | day of year (001..366) | 
-? %e +| %k | hour ( 0..23) | 
-! day of month, space padded; same as %_d +| %l | hour ( 1..12) | 
-? %F +| %m | month (01..12) | 
-! full date; same as %Y-%m-%d +| %M | minute (00..59) | 
-? %g +| %n | a newline | 
-! last two digits of year of ISO week number (see %G) +| %N | nanoseconds (000000000..999999999) | 
-? %G +| %p | locale's equivalent of either AM or PM; blank if not known | 
-! year of ISO week number (see %V); normally useful only with %V +| %P | like %p, but lower case | 
-? %h +| %r | locale's 12-hour clock time (e.g., 11:11:04 PM) | 
-! same as %b +| %R | 24-hour hour and minute; same as %H:%M | 
-? %H +| %s | seconds since 1970-01-01 00:00:00 UTC | 
-! hour (00..23) +| %S | second (00..60) | 
-? %I +| %t | a tab | 
-! hour (01..12) +| %T | time; same as %H:%M:%S |  
-? %j +| %u | day of week (1..7); 1 is Monday | 
-! day of year (001..366) +| %U | week number of year, with Sunday as first day of week (00..53) |  
-? %k +| %V | ISO week number, with Monday as first day of week (01..53) | 
-! hour ( 0..23) +| %w | day of week (0..6); 0 is Sunday | 
-? %l +| %W | week number of year, with Monday as first day of week (00..53) | 
-! hour ( 1..12) +| %x | locale's date representation (e.g., 12/31/99) | 
-? %m +| %X | locale's time representation (e.g., 23:13:48) | 
-! month (01..12) +| %y | last two digits of year (00..99) | 
-? %M +| %Y | year | 
-! minute (00..59) +| %z | +hhmm numeric timezone (e.g., -0400) | 
-? %n +| %:z | +hh:mm numeric timezone (e.g., -04:00) | 
-! a newline +| %::z |+hh:mm:ss numeric time zone (e.g., -04:00:00) | 
-? %N +| %:::z | numeric time zone  with : to necessary precision (e.g., -04, +05:30) | 
-! nanoseconds (000000000..999999999) +| %Z | alphabetic time zone abbreviation (e.g., EDT) |
-? %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 ''%'': By default, numeric fields are padded with zeroes. The following optional flags may follow ''%'':
  
-? - (hyphen) +^ Flag      ^ Meaning        ^ 
-! do not pad the field +| - (hyphen) | do not pad the field | 
-? _ (underscore) +| _ (underscore) | pad with spaces | 
-! pad with spaces +| 0 (zero) | pad with zeros | 
-? 0 (zero) +| <nowiki>^</nowiki> | use upper case if possible | 
-! pad with zeros +| # | use opposite case if possible |
-? ^ +
-! 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. 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.