localtime(3)          LPC Library Functions          localtime(3)

NAME
     localtime() - convert to local time

SYNOPSIS
     #include <localtime.h>

     mixed *localtime( int time );

DESCRIPTION
     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().

          int  LT_SEC         Seconds after the minute (0..59)
          int  LT_MIN         Minutes after the hour (0..59)
          int  LT_HOUR        Hour since midnight (0..23)
          int  LT_MDAY        Day of the month (1..31)
          int  LT_MON         Months since January (0..11)
          int  LT_YEAR        Year (guarenteed to be >= 1900)
          int  LT_WDAY        Days since Sunday (0..6)
          int  LT_YDAY        Days since January 1 (0..365)
          int  LT_GMTOFF Seconds after GMT (UTC)
          string    LT_ZONE        Timezone name

SEE ALSO
     ctime(3),    time(3),     time_expression(3),     uptime(3),
     /include/localtime.h

MudOS                Last change: 5 Sep 1994                    1