doc/efun/mktime

SYNOPSIS
        #include <time.h>

        int mktime(int *ts)

DESCRIPTION
        If the argument <ts> is an array with 9 elements (int) according to
        the result of localtime(), this function returns the number of seconds
        passed since the epoch (00:00:00 UTC, January 1, 1970).
        mktime() interprets the input data according to the current timezone
        setting of the host system.
        This can be used to store a date or time as an integer value or to
        compute differences betweens two different dates or times.

        The array <ts> has to have the following structure:
            int TM_SEC    (0):  seconds (0..59)
            int TM_MIN    (1):  minutes (0..59)
            int TM_HOUR   (2):  hours (0..23)
            int TM_MDAY   (3):  day of month (1..31)
            int TM_MON    (4):  day of year (0..11)
            int TM_YEAR   (5):  year (e.g. 2001)
            int TM_WDAY   (6):  day of week (0..6, sunday = 0)
            int TM_YDAY   (7):  day of year (0..365)
            inz TM_ISDST  (8):  Daylight Saving Time (1,0,-1)

        TM_YDAY and TM_WDAY are ignored and can contain arbitrary 
        integer values.
        TM_ISDST can be 1 (daylight saving time in effect), 0 (DST not in
        effect) or -1. A value of -1 causes the mktime() function to attempt
        to divine whether daylight saving time is in effect for the specified
        time.

EXAMPLES
        A date and time (user input) shall be stored as unix timestamp:
        // "Wed Oct 24 10:48:00 2007" corresponds to the returned time stamp:
        int unixtime = mktime( ({0, 48, 09, 24, 09, 2007, 0, 01, 0}) );

HISTORY
        Introduced in LDMud 3.3.718.

SEE ALSO
        ctime(E), gmtime(E), localtime(E), time(E), utime(E)