.\"convert to local time .DT localtime $MUDNAME$ driver help localtime .SH Name .SI 5 localtime() - convert to local time .EI .SH Synopsis .SI 5 #include <localtime.h> mixed *localtime( int time ); .EI .SH Description .SP 5 5 localtime() converts a time value (as returned by time()) into an array of values which represents the time locally. In the past time() was used to get the time in GMT (UTC), and then local definitions were used to determine the local offset from GMT. This roundabout approach is no longer necessary. localtime() returns the seconds, minutes and hours, the day, month and year, day of the week, day of the year, the name of the local timezone and how far the MUD is from GMT. This information is retrieved directly from the operating system and made available to the driver without the use of MUD-specific configuration files. localtime() returns an array containing the values specified above. The index for each value is defined symbolically in localtime.h. The following table summarizes the array returned by localtime(). .EP .SO 10 15 45 LT_SEC Seconds after the minute (0..59) LT_MIN Minutes after the hour (0..59) LT_HOUR Hour since midnight (0..23) LT_MDAY Day of the month (1..31) LT_MON Months since January (0..11) LT_YEAR Year (guarenteed to be >= 1900) LT_WDAY Days since Sunday (0..6) LT_YDAY Days since January 1 (0..365) LT_GMTOFF Seconds after GMT (UTC) LT_ZONE Timezone name .EO .SH See also .SI 5 ctime(), time(), time_expression(), uptime(), /include/localtime.h .EI