LibUI::Time - Internal Wrapper for struct tm in time.h
struct tm
time.h
# You'll probably not ever use this directly
Simple calendar times represent absolute times as elapsed times since an epoch. This is convenient for computation, but has no relation to the way people normally think of calendar time. By contrast, broken-down time is a binary representation of calendar time separated into year, month, day, and so on. Broken-down time values are not useful for calculations, but they are useful for printing human readable time information.
A broken-down time value is always relative to a choice of time zone, and it also indicates which time zone that is.
The symbols in this section are declared in the header file time.h.
Depending on your platform, there may be more but here are the basics:
tm_sec
This is the number of full seconds since the top of the minute (normally in the range 0 through 59, but the actual upper limit is 60, to allow for leap seconds if leap second support is available).
tm_min
This is the number of full minutes since the top of the hour (in the range 0 through 59).
tm_hour
This is the number of full hours past midnight (in the range 0 through 23).
tm_mday
This is the ordinal day of the month (in the range 1 through 31). Watch out for this one! As the only ordinal number in the structure, it is inconsistent with the rest of the structure.
tm_mon
This is the number of full calendar months since the beginning of the year (in the range 0 through 11). Watch out for this one! People usually use ordinal numbers for month-of-year (where January = 1).
tm_year
This is the number of full calendar years since 1900.
tm_wday
This is the number of full days since Sunday (in the range 0 through 6).
tm_yday
This is the number of full days since the beginning of the year (in the range 0 through 365).
tm_isdst
This is a flag that indicates whether Daylight Saving Time is (or was, or will be) in effect at the time described. The value is positive if Daylight Saving Time is in effect, zero if it is not, and negative if the information is not available.
tm_gmtoff
This field describes the time zone that was used to compute this broken-down time value, including any adjustment for daylight saving; it is the number of seconds that you must add to UTC to get local time. You can also think of this as the number of seconds east of UTC. For example, for U.S. Eastern Standard Time, the value is -5*60*60.
The tm_gmtoff field is derived from BSD and is a GNU library extension; it is not visible in a strict ISO C environment.
tm_zone
This field is the name for the time zone that was used to compute this broken-down time value.
Like tm_gmtoff, this field is a BSD and GNU extension, and is not visible in a strict ISO C environment.
LibUI::DateTimePicker - Select a date and time of day
LibUI::TimePicker - Select a time of day
LibUI::DatePicker - Select a calendar date
Copyright (C) Sanko Robinson.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Sanko Robinson <sanko@cpan.org>
To install LibUI, copy and paste the appropriate command in to your terminal.
cpanm
cpanm LibUI
CPAN shell
perl -MCPAN -e shell install LibUI
For more information on module installation, please visit the detailed CPAN module installation guide.