CTIME(3C)               COMMAND REFERENCE               CTIME(3C)



NAME
     ctime, localtime, gmtime, asctime, timezone - convert date
     and time to ASCII

SYNOPSIS
     char *ctime(clock)
     long *clock;

     #include <sys/time.h>

     struct tm *localtime(clock)
     long *clock;

     struct tm *gmtime(clock)
     long *clock;

     char *asctime(tm)
     struct tm *tm;

     char *timezone(zone, dst)

DESCRIPTION
     Ctime converts a time pointed to by clock such as returned
     by gettimeofday(2) into ASCII and returns a pointer to a
     26-character string in the following form.  (All the fields
     have constant width.)

          Sun Sep 16 01:03:52 1973\n\0

     Localtime and gmtime return pointers to structures
     containing the broken-down time.  Localtime corrects for the
     time zone and possible daylight savings time; gmtime
     converts directly to GMT, which is the time UTek uses.
     Asctime converts a broken-down time to ASCII and returns a
     pointer to a 26-character string.

     These quantities give the time on a 24-hour clock, day of
     month (1-31), month of year (0-11), day of week (Sunday =
     0), year - 1900, day of year (0-365), and a flag that is
     nonzero if daylight savings time is in effect.

     When local time is called for, the program consults the
     system to determine the time zone and whether the standard
     U.S.A. daylight savings time adjustment is appropriate.  The
     program knows about the peculiarities of this conversion in
     1974 and 1975; if necessary, a table for these years can be
     extended.

     Timezone returns the name of the time zone associated with
     its first argument, which is measured in minutes westward
     from Greenwich.  If the second argument is 0, the standard
     name is used; otherwise, it is the daylight savings version.



Printed 3/13/89                                                 1

CTIME(3C)               COMMAND REFERENCE               CTIME(3C)



     If the required name does not appear in a table built into
     the routine, the difference from GMT is produced. For
     example, in Afghanistan timezone(-(60*4+30), 0) is
     appropriate because it is 4:30 ahead of GMT and the string
     GMT+4:30 is produced.

CAVEATS
     The return values point to static data whose content is
     overwritten by each call.

SEE ALSO
     gettimeofday(2).











































Printed 3/13/89                                                 2

%%index%%
na:288,133;
sy:421,2017;
de:2438,2136;4934,351;
ca:5285,171;
se:5456,167;
%%index%%000000000107