NAME
LibUI::Time - Internal Wrapper for struct tm in time.h
SYNOPSIS
# You'll probably not ever use this directlyDESCRIPTION
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.
Structure Members
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_gmtofffield 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.
See Also
LibUI::DateTimePicker - Select a date and time of day
LibUI::TimePicker - Select a time of day
LibUI::DatePicker - Select a calendar date
LICENSE
Copyright (C) Sanko Robinson.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
AUTHOR
Sanko Robinson <sanko@cpan.org>