Return to timec.3 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man3

Annotation of researchv10dc/man/adm/man3/timec.3, revision 1.1

1.1     ! root        1: .TH TIMEC 3
        !             2: .CT 2 data_man time_man
        !             3: .SH NAME
        !             4: timec, timegm, timelocal \- convert ASCII to time
        !             5: .SH SYNOPSIS
        !             6: .nf
        !             7: .B #include <time.h>
        !             8: .PP
        !             9: .B long timec(string)
        !            10: .B char *string;
        !            11: .PP
        !            12: .B long timegm(timep)
        !            13: .B struct tm *timep;
        !            14: .PP
        !            15: .B long timelocal(timep, zone)
        !            16: .B struct tm *timep;
        !            17: .B char *zone;
        !            18: .fi
        !            19: .SH DESCRIPTION
        !            20: These routines are inverse to
        !            21: .IR ctime (3)
        !            22: and its relatives.
        !            23: See
        !            24: .IR ctime (3)
        !            25: for data layouts.
        !            26: .PP
        !            27: .I Timec
        !            28: converts to system format a date
        !            29: .I string
        !            30: as produced by
        !            31: .I ctime,
        !            32: .IR date (1),
        !            33: or
        !            34: .IR ls (1).
        !            35: An optional day of the week is ignored.
        !            36: A month name and day are required.
        !            37: A missing hour:min[:sec] field is taken to be 
        !            38: .BR 00:00:00 .
        !            39: An optional time zone (local time by default)
        !            40: may appear before or after the year.
        !            41: A missing year is assumed to be the past 12-month interval.
        !            42: .PP
        !            43: .I Timegm
        !            44: returns the system-format time corresponding to
        !            45: the broken-down GMT time
        !            46: pointed to by
        !            47: .IR timep .
        !            48: In a copy of the broken-down time
        !            49: .BR tm_mon 
        !            50: is reduced mod 12 by carrying (positively or negatively) to
        !            51: .BR tm_year .
        !            52: Next
        !            53: .B tm_mon
        !            54: and
        !            55: .B tm_mday
        !            56: are added to
        !            57: .B tm_yday
        !            58: appropriately for
        !            59: .BR tm_year .
        !            60: Then
        !            61: .BR tm_sec ,
        !            62: .BR tm_min ,
        !            63: .BR tm_hour ,
        !            64: .BR tm_yday ,
        !            65: and
        !            66: .B tm_year 
        !            67: are adjusted by carrying.
        !            68: Finally the system-format date
        !            69: is calculated from these 5 fields.
        !            70: .PP
        !            71: .I Timelocal
        !            72: is like
        !            73: .I timegm,
        !            74: except that the broken-down time belongs to the specified time
        !            75: .I zone,
        !            76: or is local time if
        !            77: .I zone 
        !            78: is zero.
        !            79: .PP
        !            80: Time zones and months are recognized by the first three
        !            81: characters, regardless of case.
        !            82: .I Strings
        !            83: for
        !            84: .I ctime
        !            85: may contain names longer than three characters
        !            86: and may contain extra white space and commas.
        !            87: .SH EXAMPLES
        !            88: .TP
        !            89: Set a date ahead one month:
        !            90: .EX
        !            91: struct tm brk_out = *localtime(&date);
        !            92: brk_out.tm_yday = 0;
        !            93: brk_out.tm_mon++; 
        !            94: date = timelocal(&brk_out,0);
        !            95: .EE
        !            96: .HP
        !            97: Convert a
        !            98: .IR date (1)
        !            99: string to system format:
        !           100: .EX
        !           101: date = timec("Sat Sep 27 20:59:11 EDT 1986");
        !           102: .EE
        !           103: .SH SEE ALSO
        !           104: .IR ctime (3),
        !           105: .IR time (2)
        !           106: .SH BUGS
        !           107: Unknown time zone names are taken to be GMT.
        !           108: .br
        !           109: Times before the epoch yield nonsense.

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