---
layout: doc
title: system / localtime
---
# localtime

### 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
         int        LT_ISDST    If DST is currently being observed

### SEE ALSO

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