Return to ctime.3 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man3

Annotation of cci/usr/src/man/man3/ctime.3, revision 1.1.1.1

1.1       root        1: .TH CTIME 3  "26 June 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: ctime, localtime, gmtime, asctime, timezone \-  convert date and time to ASCII
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B char *ctime(clock)
                      8: .B long *clock;
                      9: .PP
                     10: .B #include <sys/time.h>
                     11: .PP
                     12: .B struct tm *localtime(clock)
                     13: .B long *clock;
                     14: .PP
                     15: .B struct tm *gmtime(clock)
                     16: .B long *clock;
                     17: .PP
                     18: .B char *asctime(tm)
                     19: .B struct tm *tm;
                     20: .PP
                     21: .B char *timezone(zone, dst)
                     22: .fi
                     23: .SH DESCRIPTION
                     24: .I Ctime
                     25: converts a time pointed to by
                     26: .I clock
                     27: such as returned by
                     28: .IR time (2)
                     29: into ASCII
                     30: and returns a pointer to a
                     31: 26-character string
                     32: in the following form.
                     33: All the fields have constant width.
                     34: .PP
                     35:     Sun Sep 16 01:03:52 1973\\n\\0
                     36: .PP
                     37: .I Localtime
                     38: and
                     39: .I gmtime
                     40: return pointers to structures containing
                     41: the broken-down time.
                     42: .I Localtime
                     43: corrects for the time zone and possible daylight savings time;
                     44: .I gmtime
                     45: converts directly to GMT, which is the time UNIX uses.
                     46: .I Asctime
                     47: converts a broken-down time to ASCII and returns a pointer
                     48: to a 26-character string.
                     49: .PP
                     50: The structure declaration from the include file is:
                     51: .PP
                     52: .RS
                     53: .nf
                     54: struct tm {
                     55:        int     tm_sec;
                     56:        int     tm_min;
                     57:        int     tm_hour;
                     58:        int     tm_mday;
                     59:        int     tm_mon;
                     60:        int     tm_year;
                     61:        int     tm_wday;
                     62:        int     tm_yday;
                     63:        int     tm_isdst;
                     64: };
                     65: .fi
                     66: .RE
                     67: .PP
                     68: These quantities give the time on a 24-hour clock,
                     69: day of month (1-31), month of year (0-11), day of week
                     70: (Sunday = 0), year \- 1900, day of year (0-365),
                     71: and a flag that is nonzero if daylight saving time is in effect.
                     72: .PP
                     73: When local time is called for,
                     74: the program consults the system to determine the time zone and
                     75: whether the U.S.A., Australian, Eastern European, Middle European,
                     76: or Western European daylight saving time adjustment is appropriate.
                     77: The program knows about various peculiarities in time conversion
                     78: over the past 10-20 years; if necessary, this understanding can
                     79: be extended.
                     80: .PP
                     81: .I Timezone
                     82: returns the name of the time zone associated with its first argument,
                     83: which is measured in minutes westward from Greenwich.
                     84: If the second argument is 0, the standard name is used,
                     85: otherwise the Daylight Saving version.
                     86: If the required name does not appear in a table
                     87: built into the routine,
                     88: the difference from GMT is produced; e.g.
                     89: in Afghanistan
                     90: .I timezone(-(60*4+30), 0)
                     91: is appropriate because it is 4:30 ahead of GMT
                     92: and the string
                     93: .B GMT+4:30
                     94: is produced.
                     95: .SH "SEE ALSO"
                     96: gettimeofday(2), time(3)
                     97: .SH BUGS
                     98: The return values point to static data
                     99: whose content is overwritten by each call.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.