NAME

localtime() - convert to local time

SYNOPSIS

#include 

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)