Return to ctime.3 CVS log

Up to [Research Unix] / researchv10dc / dist / man / v4 / man3

Annotation of researchv10dc/dist/man/v4/man3/ctime.3, revision 1.1.1.1

1.1       root        1: .th CTIME III 10/15/73
                      2: .sh NAME
                      3: ctime  \*-  convert date and time to ASCII
                      4: .sh SYNOPSIS
                      5: .ft B
                      6: char *ctime(tvec)
                      7: .br
                      8: int tvec[2];
                      9: .s3
                     10: .ft R
                     11: [from Fortran]
                     12: .br
                     13: .ft B
                     14: double precision ctime
                     15: .br
                     16: .li
                     17: ... = ctime(dummy)
                     18: .s3
                     19: int *localtime(tvec)
                     20: .br
                     21: int tvec[2];
                     22: .s3
                     23: int *gmtime(tvec)
                     24: .br
                     25: int tvec[2];
                     26: .br
                     27: .ft R
                     28: .sh DESCRIPTION
                     29: .it Ctime
                     30: converts a time in the vector
                     31: .it tvec
                     32: such as returned by time (II)
                     33: into ASCII
                     34: and returns a pointer to a
                     35: character string
                     36: in the form
                     37: .s3
                     38:     Sun Sep 16 01:03:52 1973\\n\\0
                     39: .s3
                     40: All the fields have constant width.
                     41: .s3
                     42: Once the time has been placed into
                     43: .it t
                     44: and
                     45: .it t+2,
                     46: this routine is callable from assembly language
                     47: as follows:
                     48: .s3
                     49: .nf
                     50: .ft B
                     51:        mov     $t,\*-(sp)
                     52:        jsr     pc,\*_ctime
                     53:        tst     (sp)+
                     54: .s3
                     55: .ft R
                     56: .fi
                     57: and a pointer to the string is available in r0.
                     58: .s3
                     59: The
                     60: .it localtime
                     61: and
                     62: .it gmtime
                     63: entries return integer vectors to the broken-down time.
                     64: .it Localtime
                     65: corrects for the time zone and possible daylight savings time;
                     66: .it gmtime
                     67: converts directly to GMT, which is the time UNIX uses.
                     68: The value is a pointer
                     69: to an array whose components are
                     70: .s3
                     71: .lp +5 5
                     72: 0      seconds
                     73: .lp +5 5
                     74: 1      minutes
                     75: .lp +5 5
                     76: 2      hours
                     77: .lp +5 5
                     78: 3      day of the month (1-31)
                     79: .lp +5 5
                     80: 4      month (0-11)
                     81: .lp +5 5
                     82: 5      year \*- 1900
                     83: .lp +5 5
                     84: 6      day of the week (Sunday = 0)
                     85: .lp +5 5
                     86: 7      day of the year (0-365)
                     87: .lp +5 5
                     88: 8      Daylight Saving Time flag if non-zero
                     89: .i0
                     90: .s3
                     91: The external variable
                     92: .it timezone
                     93: contains the difference, in seconds, between GMT and local
                     94: standard time (in EST, is 5*60*60);
                     95: the external variable
                     96: .it daylight
                     97: is non-zero iff the standard U.S.A. Daylight
                     98: Saving Time conversion should be applied
                     99: between the last Sundays in April and October.
                    100: The external variable
                    101: .it nixonflg
                    102: if non-zero
                    103: supersedes
                    104: .it daylight
                    105: and causes daylight time all year round.
                    106: .s3
                    107: A routine named
                    108: .it ctime
                    109: is also available from Fortran.
                    110: Actually it more resembles the
                    111: .it time
                    112: (II) system entry in that it returns the number of seconds
                    113: since the epoch
                    114: 0000 GMT Jan. 1, 1970
                    115: (as a floating-point number).
                    116: .sh "SEE ALSO"
                    117: time(II)
                    118: .sh BUGS

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