C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
mktime
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The mktime function converts the time structure pointed to by
     <timeptr> into a fully defined structure with "normalized" values.
     Then the function converts the contents of the structure into a
     time_t calendar time value. The structure at <timeptr> may be
     incomplete. The mktime function handles dates in any time zone
     from midnight, December 31, 1899 to midnight, February 5, 2036.
 
     The converted time has the same encoding as the values returned by
     the time function. The original values of the tm_wday and tm_yday
     components of the <timeptr> structure are ignored, and the
     original values of the other components are not restricted to
     their normal ranges.
 
     If successful, mktime sets the values of tm_wday and tm_yday
     appropriately. It sets the other components to represent the
     specified calendar time, but their values are forced to the
     normal ranges. The final value of tm_mday is not set until tm_mon
     and tm_year are determined.
 
     Note that the gmtime and localtime functions use a single
     statically allocated buffer for the conversion. If you supply this
     buffer to mktime, the previous contents will be destroyed.
 
     Return Value
 
     The mktime function returns the specified calendar time encoded as
     a value of type time_t. If <timeptr> references a date before
     midnight, December 31, 1899, mktime returns -1 cast as type time_t.
                                    -♦-