- _\bL_\bo_\bc_\ba_\bl_\bt_\bi_\bm_\be and _\bg_\bm_\bt_\bi_\bm_\be return pointers to ``tm'' structures,
- described below. _\bL_\bo_\bc_\ba_\bl_\bt_\bi_\bm_\be corrects for the time zone and
- any time zone adjustments (such as Daylight Saving Time in
- the U.S.A.). Before doing so, _\bl_\bo_\bc_\ba_\bl_\bt_\bi_\bm_\be calls _\bt_\bz_\bs_\be_\bt (if
- _\bt_\bz_\bs_\be_\bt has not been called in the current process). After
- filling in the ``tm'' structure, _\bl_\bo_\bc_\ba_\bl_\bt_\bi_\bm_\be sets the
- t\btm\bm_\b_i\bis\bsd\bds\bst\bt'th element of t\btz\bzn\bna\bam\bme\be to a pointer to an ASCII
- string that's the time zone abbreviation to be used with
- _\bl_\bo_\bc_\ba_\bl_\bt_\bi_\bm_\be's return value.
-
- _\bG_\bm_\bt_\bi_\bm_\be converts to Coordinated Universal Time.
-
- _\bA_\bs_\bc_\bt_\bi_\bm_\be converts a time value contained in a ``tm'' struc-
- ture to a 26-character string, as shown in the above exam-
- ple, and returns a pointer to the string.
-
- _\bM_\bk_\bt_\bi_\bm_\be converts the broken-down time, expressed as local
- time, in the structure pointed to by _\bt_\bm into a calendar time
- value with the same encoding as that of the values returned
- by the _\bt_\bi_\bm_\be function. The original values of the t\btm\bm_\b_w\bwd\bda\bay\by
- and t\btm\bm_\b_y\byd\bda\bay\by components of the structure are ignored, and the
- original values of the other components are not restricted
- to their normal ranges. (A positive or zero value for
- t\btm\bm_\b_i\bis\bsd\bds\bst\bt causes _\bm_\bk_\bt_\bi_\bm_\be to presume initially that summer time
- (for example, Daylight Saving Time in the U.S.A.) respec-
- tively, is or is not in effect for the specified time. A
- negative value for t\btm\bm_\b_i\bis\bsd\bds\bst\bt causes the _\bm_\bk_\bt_\bi_\bm_\be function to
- attempt to divine whether summer time is in effect for the
- specified time.) On successful completion, the values of the
- t\btm\bm_\b_w\bwd\bda\bay\by and t\btm\bm_\b_y\byd\bda\bay\by components of the structure are set
- appropriately, and the other components are set to represent
- the specified calendar time, but with their values forced to
- their normal ranges; the final value of t\btm\bm_\b_m\bmd\bda\bay\by is not set
- until t\btm\bm_\b_m\bmo\bon\bn and t\btm\bm_\b_y\bye\bea\bar\br are determined. _\bM_\bk_\bt_\bi_\bm_\be returns the
-
-
-
-Printed 7/27/90 June 4
-
-
-
-
-
-
-CTIME(3) 1990 CTIME(3)
-
-
-
- specified calendar time; If the calendar time cannot be
- represented, it returns -\b-1\b1.
-
- _\bD_\bi_\bf_\bf_\bt_\bi_\bm_\be returns the difference between two calendar times,
- _\bt_\bi_\bm_\be_\b1 - _\bt_\bi_\bm_\be_\b0, expressed in seconds.
-
- Declarations of all the functions and externals, and the
- ``tm'' structure, are in the <\b<t\bti\bim\bme\be.\b.h\bh>\b> header file. The
- structure (of type) s\bst\btr\bru\buc\bct\bt t\btm\bm includes the following fields:
-
- int tm_sec; /* seconds (0 - 60) */
- int tm_min; /* minutes (0 - 59) */
- int tm_hour; /* hours (0 - 23) */
- int tm_mday; /* day of month (1 - 31) */
- int tm_mon; /* month of year (0 - 11) */
- int tm_year; /* year - 1900 */
- int tm_wday; /* day of week (Sunday = 0) */
- int tm_yday; /* day of year (0 - 365) */
- int tm_isdst; /* is summer time in effect? */
- char *tm_zone; /* abbreviation of timezone name */
- long tm_gmtoff; /* offset from UTC in seconds */
-
- The _\bt_\bm__\bz_\bo_\bn_\be and _\bt_\bm__\bg_\bm_\bt_\bo_\bf_\bf fields exist, and are filled in,
- only if arrangements to do so were made when the library
- containing these functions was created. There is no guaran-
- tee that these fields will continue to exist in this form in
- future releases of this code.
-
- _\bT_\bm__\bi_\bs_\bd_\bs_\bt is non-zero if summer time is in effect.
-
- _\bT_\bm__\bg_\bm_\bt_\bo_\bf_\bf is the offset (in seconds) of the time represented
- from UTC, with positive values indicating east of the Prime
- Meridian.
-
-F\bFI\bIL\bLE\bES\bS
- /usr/share/zoneinfo time zone information direc-
- tory
- /usr/share/zoneinfo/localtime local time zone file
- /usr/share/zoneinfo/posixrules used in converting POSIX-
- style TZ's
- /usr/share/zoneinfo/GMT for UTC leap seconds
-
- If /_\bu_\bs_\br/_\bs_\bh_\ba_\br_\be/_\bz_\bo_\bn_\be_\bi_\bn_\bf_\bo/_\bG_\bM_\bT is absent, UTC leap seconds are
- loaded from /_\bu_\bs_\br/_\bs_\bh_\ba_\br_\be/_\bz_\bo_\bn_\be_\bi_\bn_\bf_\bo/_\bp_\bo_\bs_\bi_\bx_\br_\bu_\bl_\be_\bs.
+ The a\bas\bsc\bct\bti\bim\bme\be() function converts the broken down time in the structure _\bt_\bm
+ pointed at by _\b*_\bt_\bm to the form shown in the example above.
+
+ The function m\bmk\bkt\bti\bim\bme\be() converts the broken-down time, expressed as local
+ time, in the structure pointed to by tm into a time value with the same
+ encoding as that of the values returned by the time(3) function, that is,
+ seconds from the Epoch, UTC.
+
+ The original values of the _\bt_\bm_\b__\bw_\bd_\ba_\by and _\bt_\bm_\b__\by_\bd_\ba_\by components of the struc-
+ ture are ignored, and the original values of the other components are not
+ restricted to their normal ranges. (A positive or zero value for
+ _\bt_\bm_\b__\bi_\bs_\bd_\bs_\bt causes m\bmk\bkt\bti\bim\bme\be() to presume initially that summer time (for exam-
+ ple, Daylight Saving Time) is or is not in effect for the specified time,
+ respectively. A negative value for _\bt_\bm_\b__\bi_\bs_\bd_\bs_\bt causes the m\bmk\bkt\bti\bim\bme\be() function
+ to attempt to divine whether summer time is in effect for the specified
+ time.)
+
+ On successful completion, the values of the _\bt_\bm_\b__\bw_\bd_\ba_\by and _\bt_\bm_\b__\by_\bd_\ba_\by compo-
+ nents of the structure are set appropriately, and the other components
+ are set to represent the specified calendar time, but with their values
+ forced to their normal ranges; the final value of _\bt_\bm_\b__\bm_\bd_\ba_\by is not set un-
+ til _\bt_\bm_\b__\bm_\bo_\bn and _\bt_\bm_\b__\by_\be_\ba_\br are determined. M\bMk\bkt\bti\bim\bme\be() returns the specified
+ calendar time; if the calendar time cannot be represented, it returns -1;
+
+ The d\bdi\bif\bff\bft\bti\bim\bme\be() function returns the difference between two calendar
+ times, (_\bt_\bi_\bm_\be_\b1 - _\bt_\bi_\bm_\be_\b0), expressed in seconds.
+
+ External declarations as well as the tm structure definition are in the
+ <_\bt_\bi_\bm_\be_\b._\bh> include file. The tm structure includes at least the following
+ fields:
+
+ int tm_sec; /* seconds (0 - 60) */
+ int tm_min; /* minutes (0 - 59) */
+ int tm_hour; /* hours (0 - 23) */
+ int tm_mday; /* day of month (1 - 31) */
+ int tm_mon; /* month of year (0 - 11) */
+ int tm_year; /* year - 1900 */
+ int tm_wday; /* day of week (Sunday = 0) */
+ int tm_yday; /* day of year (0 - 365) */
+ int tm_isdst; /* is summer time in effect? */
+ char *tm_zone; /* abbreviation of timezone name */
+ long tm_gmtoff; /* offset from UTC in seconds */
+
+ The field _\bt_\bm_\b__\bi_\bs_\bd_\bs_\bt is non-zero if summer time is in effect.
+
+ The field _\bt_\bm_\b__\bg_\bm_\bt_\bo_\bf_\bf is the offset (in seconds) of the time represented
+ from UTC, with positive values indicating east of the Prime Meridian.
projects / unix-history / blobdiff