====== time plugin ======

This plugin provides some basic date and time functions. This plugin will always be linked statically into LCD4Linux, and therefore does not follow the 'plugin_name::function' scheme.

----

===== Functions: =====

|time()|returns the number of seconds since 00:00:00 UTC, January 1, 1970|
|strftime(format, time)|converts a time value according to <format>|
|strftime_tz(format, time, timezone)|Sane as strftime() but with additonal time zone specification|

Both functions simply use the corresponding C functions, so for details have a look at time(3) and strftime(3).

For your convience, I've extracted the strftime stuff from the man page:

|%a|The abbreviated weekday name according to the current locale.|
|%A|The full weekday name according to the current locale.|
|%b|The abbreviated month name according to the current locale.|
|%B|The full month name according to the current locale.|
|%c|The preferred date and time representation for the current locale.|
|%C|The century number (year/100) as a 2-digit integer. (SU)|
|%d|The day of the month as a decimal number (range 01 to 31).|
|%D|Equivalent to %m/%d/%y. (Yecch -- for Americans only.  Americans should note that in other countries %d/%m/%y is rather common. This means that in international context this format is ambiguous and should not be used.) (SU)|
|%e|Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space. (SU)|
|%E|Modifier: use alternative format, see below. (SU)|
|%F|Equivalent to %Y-%m-%d (the ISO 8601 date format). (C99)|
|%G|The ISO 8601 year with century as a decimal number.  The 4-digit year corresponding to the ISO week number (see %V).  This  has  the  same format and value as %y, except that if the ISO week number belongs to the previous or next year, that year is used instead. (TZ)|
|%g|Like %G, but without century, i.e., with a 2-digit year (00-99). (TZ)|
|%h|Equivalent to %b. (SU)|
|%H|The hour as a decimal number using a 24-hour clock (range 00 to 23).|
|%I|The hour as a decimal number using a 12-hour clock (range 01 to 12).|
|%j|The day of the year as a decimal number (range 001 to 366).|
|%k| The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.) (TZ)|
|%l|The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.) (TZ)|
|%m|The month as a decimal number (range 01 to 12).|
|%M|The minute as a decimal number (range 00 to 59).|
|%n|A newline character. (SU)|
|%O|Modifier: use alternative format, see below. (SU)|
|%p|Either  `AM'  or `PM' according to the given time value, or the corresponding strings for the current locale.  Noon is treated as `pm' and midnight as `am'.|
|%P|Like %p but in lowercase: `am' or `pm' or a corresponding string for the current locale. (GNU)|
|%r|The time in a.m. or p.m. notation.  In the POSIX locale this is equivalent to `%I:%M:%S %p'. (SU)|
|%R|The time in 24-hour notation (%H:%M). (SU) For a version including the seconds, see %T below.|
|%s|The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC. (TZ)|
|%S|The second as a decimal number (range 00 to 60).  (The range is up to 60 to allow for occasional leap seconds.)|
|%t|A tab character. (SU)|
|%T|The time in 24-hour notation (%H:%M:%S). (SU)|
|%u|The day of the week as a decimal, range 1 to 7, Monday being 1.  See also %w. (SU)|
|%U|The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week  01.  See also %V and %W.|
|%V|The  ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. See also %U and %W. (SU)|
|%w|The day of the week as a decimal, range 0 to 6, Sunday being 0.  See also %u.|
|%W|The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01.|
|%x|The preferred date representation for the current locale without the time.|
|%X|The preferred time representation for the current locale without the date.|
|%y|The year as a decimal number without a century (range 00 to 99).|
|%Y|The year as a decimal number including the century.|
|%z|The time-zone as hour offset from GMT.  Required to emit RFC 822-conformant dates (using "%a, %d %b %Y %H:%M:%S %z"). (GNU)|
|%Z|The time zone or name or abbreviation.|
|%+|The date and time in date(1) format. (TZ) (Not supported in glibc2.)|
|%%|A literal `%' character.|

----


===== Time Zones: =====

For the time zone specification, you can set whatever Linux accepts as its "TZ" environment. Normally that's a city like "Europe/Berlin" (see /usr/share/zoneinfo) or a generic time zone string like "UTC". See also the tzset(3) manual page.

----

===== Example =====

<code>
Widget Time {
    class 'Text'
    expression strftime('%a,%d/%m %H:%M:%S',time())
    width 20
    align 'E'
    update 1000
}
</code>


----