====== 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.