Xfce Wiki

Sub domains
 
no way to compare when less than two revisions

Differences

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


—xfce:xfce4-panel:4.10:clock [2015/03/11 13:32] (current) – created ochosi
Line 1: Line 1:
 +====== Clock ======
 +
 +The //Clock// panel plugin displays the current time in a variety of styles and formats.
 +
 +====== Properties ======
 +
 +<figure "Clock's properties dialog">
 +{{:xfce:xfce4-panel:clock.png?nolink&|}}
 +</figure>
 +
 +===== Appearance =====
 +
 +? Tooltip Format
 +! Changes how the time is displayed when hovering over the clock display. 
 +? Show Frame
 +! Displays a frame around the clock display.
 +? Layout
 +  ? Analog
 +  ! Displays time as a clock face with hands representing the current hour, minute, and seconds. 
 +  ? Binary
 +  ! 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 =====
 +
 +<note tip>The options available in //Clock Options// will vary depending on the clock {gui>Layout} selected.</note>
 +
 +? 24-hour Clock
 +! Displays time in a 24-hour (military) format. ({gui>LCD} layout only.) 
 +? 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.) 
 +
 +===== 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:
 +
 +  %R%n<span size='x-small'>%d-%m w%V</span>
 +
 +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''):
 +
 +? %%
 +! 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 zeroes. The following optional flags may follow ''%'':
 +
 +? - (hyphen)
 +! 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.