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     ! 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.