Xfce Wiki

Sub domains
 

Differences

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

Link to this comparison view

Next revision
Previous revision
xfce:xfce4-panel:clock [2012/01/04 09:18]
nick created
xfce:xfce4-panel:clock [2019/04/12 22:36] (current)
blueberrybrownie [Preferences]
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 ​=====
  
-Clock's properties dialog ^ +<figure "Clock Preferences">​{{:​xfce:​xfce4-panel:​xfce4-panel-clock.png?​nolink&​|}}</​figure>​
-{{:​xfce:​xfce4-panel:​clock.png?​nolink&​|}} ​|+
  
-==== Appearance ​====+===== 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.
  
-? Tooltip Format +===== Appearance =====
-! Changes how the time is displayed when hovering over the clock display.  +
-? Show Frame +
-! Displays a frame around the clock display.+
 ? Layout ? Layout
-  ​Analog +    ​Analogue 
-  ! Displays ​time as a clock face with hands representing the current ​hour, minuteand 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.
  
-==== Clock Options ====+? Tooltip format 
 +! Changes the format of the time that gets displayed in the tooltip when hovering over the clock plugin.
  
-<note tip>The options available ​in //Clock Options// ​will vary depending on the clock {gui>​Layout} selected.</​note>​+===== Clock Options ===== 
 +The options available will vary depending on the clock {gui>​Layout} selected.
  
-? 24-hour Clock +^ Analogue ^^  
-! Displays time in a 24-hour (military) format. ({gui>​LCD} layout only.)  +Display seconds ​Displays the seconds ​hand on the clock face |
-Display ​Seconds +
-! 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. ({gui>​LCD} layout only.)  +
-? Format +
-! Changes the time format of the clock with predefined or custom layout. ({gui>​Digital} layout only.)  +
-? 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.)  +
-? Show AM/PM +
-Displays ​an '​A'​ or '​P'​ to indicate ​the time of day. ({gui>​LCD} layout only.)  +
-? Show Grid +
-! Adds gridlines to the clock. ({gui>​Binary} layout only.)  +
-? Show Inactive Dots +
-! All dots that are empty are not shown in the clock display. ({gui>​Binary} layout only.)  +
-? True Binary Clock +
-! Displays a seconds ​indicator in the clock display. ({gui>​Binary} layout only.) ​+
  
 +^ Binary ^^ 
 +| 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 grid | Adds gridlines to the clock |
 +
 +^ Digital ^^ 
 +| Format | Changes the format in which the time is displayed with a predefined or custom format |
 +
 +^ Fuzzy ^^ 
 +| 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 =====
 +
 +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 [[http://​developer.gnome.org/​pango/​stable/​PangoMarkupFormat.html|Pango Text Attribute Markup]] manual to see what attributes are 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) | 
 +| %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 0's. The following optional flags may follow ''​%'':​
 +
 +^ Flag      ^ Meaning ​       ^
 +| - (hyphen) | do not pad the field |
 +| _ (underscore) | pad with spaces |
 +| 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).