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
panel-plugins:xfce4-datetime-plugin:start [2019/11/12 00:17] – removed kevinbowenpanel-plugins:xfce4-datetime-plugin:start [2025/12/08 02:02] (current) – add note indicating plugin is EOL kevinbowen
Line 1: Line 1:
 +~~NOTOC~~
 +====== xfce4-datetime-plugin DateTime ======
  
 +xfce4-datetime-plugin shows the date and time in the panel; when left-clicked, a popup calendar appears.
 +
 +<note important>As of the 4.18 release, this plugin is considered **End-of-Life(EOL)**. For similar functionality, consider using the built-in [[https://docs.xfce.org/xfce/xfce4-panel/clock|Clock]] plugin.</note>
 +
 +  * **[[#Screenshots|Screenshots]]**
 +  * **[[#Properties Dialog|Properties]]**
 +  * **[[#Latest Release|Latest Release]]**
 +  * **[[#Source Code Repository|Source Code Repository]]**
 +  * **[[#Reporting Bugs|Reporting Bugs]]**
 +
 +----
 +
 +The original plugin was written by Choe Hwanjin. Remco den Breeje wrote the 0.4.x and 0.5.0 versions. Diego Ongaro was the maintainer from 2008 to 2010.
 +
 +===== Usage =====
 +  * Install the datetime package in the usual way for your distribution, or get the source and run ./configure, make, make install.
 +  * Right-click the Xfce panel > Add New Item > DateTime
 +    * See [[:xfce:xfce4-panel:add-new-items|Add the plugin to the panel]] for more details
 +
 +==== Calendar ====
 +To open the calendar, simply left-click the plugin on your panel. Left-click on it again to close the calendar. 
 +
 +Note: The information on which day the calendar week starts is derived from the locale.
 +
 +----
 +
 +===== Screenshots =====
 +
 +<figure "Date/Time Plugin: Calender Pop-up">
 +{{:panel-plugins:xfce4-datetime-plugin:calendartooltip.png|Date/Time Plugin: Calendar Pop-up}}
 +</figure>
 +
 +<figure "Date/Time Plugin: Available Layout Formats">
 +{{:panel-plugins:xfce4-datetime-plugin:dt1.png|Date/Time Plugin: Available Layout Formats}}
 +</figure>
 +
 +<figure "Date/Time Plugin: Tooltip Formats">
 +{{:panel-plugins:xfce4-datetime-plugin:dt2.png|Date/Time Plugin: Available Layout Formats}}
 +</figure>
 +
 +<figure "Date/Time Plugin: Clock Formats">
 +{{:panel-plugins:xfce4-datetime-plugin:dt3.png|Date/Time Plugin: Clock Formats}}
 +</figure>
 +
 +[[|Back To Top]]
 +----
 +
 +==== Properties Dialog ====
 +
 +To open the properties dialog, right-click the plugin on your panel and select Properties.
 +
 +The properties dialog allows you to use a "Custom" format string for your date or time options. The format string you enter should be compatible with strftime. Here are some format string specifiers from the "date" command's help:
 +
 +  %%   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
 +  %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   alphabetic time zone abbreviation (e.g., EDT)
 +
 +[[|Back To Top]]
 +----
 +
 +
 +===== Latest Release =====
 +
 +{{rss>https://archive.xfce.org/feeds/project/xfce4-datetime-plugin 1 date 2h}}
 +
 +[[https://gitlab.xfce.org/panel-plugins/xfce4-datetime-plugin/-/blob/master/NEWS|Read the CHANGELOG]]
 +
 +  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-datetime-plugin/|Download current release]]** (older versions of this component are also available here)
 +
 +[[|Back to Top]]
 +
 +----
 +
 +===== Source Code Repository =====
 +
 +[[https://gitlab.xfce.org/panel-plugins/xfce4-datetime-plugin]]
 +
 +----
 +
 +===== Reporting Bugs =====
 +
 +  * **[[:panel-plugins:xfce4-datetime-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports
 +
 +
 +[[|Back To Top]]
 +----
 +[[ :xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]