Charles.Forsyth20070901-1541de2f8de19 years agoHistory
115 lines · 2.7 KB · Text
RawDownload
.TH DAYTIME 2.SH NAMEdaytime: text, filet, gmt, local, now, string2tm, time, tm2epoch \- time conversions.SH SYNOPSIS.EXinclude "daytime.m";daytime := load Daytime Daytime->PATH; Tm: adt{    sec:    int;    # seconds (0 to 59)    min:    int;    # minutes (0 to 59)    hour:   int;    # hours (0 to 23)    mday:   int;    # day of the month (1 to 31)    mon:    int;    # month (0 to 11)    year:   int;    # year-1900; 2000AD is 100    wday:   int;    # day of week (0 to 6, Sunday is 0)    yday:   int;    # day of year (0 to 365)    zone:   string; # time zone name    tzoff:  int;    # time zone offset (seconds from GMT)}; text:      fn(tm: ref Tm): string;filet:     fn(now, t: int): string;gmt:       fn(tim: int): ref Tm;local:     fn(tim: int): ref Tm;now:       fn(): int;time:      fn(): string;tm2epoch:  fn(tm: ref Tm): int;string2tm: fn(date: string): ref Tm;.EE.SH DESCRIPTIONThese routines perform time conversions relative to theepoch 00:00:00 GMT, Jan. 1, 1970.Note the range of values for each member of the.B Tmadt.The conventions are the same as those of C's.IR ctime ..PP.B Textconverts a time structure referenced by.I tmfrom local or GMT time to a string in the format:.IP.B "Sat Jan  1 13:00:00 GMT 2000".PP.B Filetconverts the file access or modification time.I tfrom seconds since the epoch to local time as a stringin the format:.IP.B "Jan  1 13:00".PPif the file is less than 6 months old or.IP.B "Jan  1 2000".PPif the file is older than 6 months, compared to the time.IR now ..PP.B Gmtconverts seconds since the epoch, received in.IR tim ,to a time structure in Greenwich Mean Time (GMT)..PP.B Localconverts seconds since the epoch, received in.IR tim ,to a time structure in local time..PP.B Nowreturns the time in seconds since the epoch, obtained by reading.B /dev/time(see.IR cons (3))..PP.B Timeconverts seconds since the epochto the local time as a string in the format.BR "Fri May 19 17:01:36 BST 2000" ..PP.B Tm2epochconverts a time structure referenced by.I tmfrom local or GMT time to seconds since the epoch..PP.B String2tmreturns a reference to a.B Tmvalue corresponding to the date and time in textual form in string.IR s ,which must have one of the forms below:.IP.EXSun, 06 Nov 1994 08:49:37 GMT    \fR(RFC822, RFC1123)\fPSunday, 06-Nov-94 08:49:37 GMT   \fR(RFC850)\fPSun Nov  6 08:49:37 GMT 1994     \fR(output of \fPtext\fR, above)\fP.EE.PPA missing time zone in any format is assumed to be.BR GMT ..B String2tmreturns nil if.I sis not correctly formed..SH SOURCE.B /appl/lib/daytime.b.SH SEE ALSO.IR cons (3),.IR sys-millisec (2).SH BUGSThe sign bit of a Limbo integer holding a time will turn on 68 years from theepoch.