diff options
Diffstat (limited to 'man/2')
| -rw-r--r-- | man/2/INDEX | 1 | ||||
| -rw-r--r-- | man/2/daytime | 45 |
2 files changed, 33 insertions, 13 deletions
diff --git a/man/2/INDEX b/man/2/INDEX index f61422c4..61a1e4d0 100644 --- a/man/2/INDEX +++ b/man/2/INDEX @@ -28,6 +28,7 @@ filet daytime gmt daytime local daytime now daytime +string2tm daytime text daytime time daytime tm2epoch daytime diff --git a/man/2/daytime b/man/2/daytime index 9e284916..01b8a85d 100644 --- a/man/2/daytime +++ b/man/2/daytime @@ -1,6 +1,6 @@ .TH DAYTIME 2 .SH NAME -daytime: text, filet, gmt, local, now, time, tm2epoch \- time conversions +daytime: text, filet, gmt, local, now, string2tm, time, tm2epoch \- time conversions .SH SYNOPSIS .EX include "daytime.m"; @@ -20,13 +20,14 @@ Tm: adt 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; +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 DESCRIPTION These routines perform time conversions relative to the @@ -42,7 +43,7 @@ converts a time structure referenced by .I tm from local or GMT time to a string in the format: .IP -.BR "Sat Jan 1 13:00:00 GMT 2000" . +.B "Sat Jan 1 13:00:00 GMT 2000" .PP .B Filet converts the file access or modification time @@ -70,12 +71,10 @@ converts seconds since the epoch, received in to a time structure in local time. .PP .B Now -returns the time in seconds since the epoch, which -it obtains by reading +returns the time in seconds since the epoch, obtained by reading .B /dev/time (see -.IR cons (3)) -to get the time in microseconds since the epoch. +.IR cons (3)). .PP .B Time converts seconds since the epoch @@ -86,6 +85,26 @@ to the local time as a string in the format converts a time structure referenced by .I tm from local or GMT time to seconds since the epoch. +.PP +.B String2tm +returns a reference to a +.B Tm +value corresponding to the date and time in textual form in string +.IR s , +which must have one of the forms below: +.IP +.EX +Sun, 06 Nov 1994 08:49:37 GMT \fR(RFC822, RFC1123)\fP +Sunday, 06-Nov-94 08:49:37 GMT \fR(RFC850)\fP +Sun Nov 6 08:49:37 GMT 1994 \fR(output of \fPtext\fR, above)\fP +.EE +.PP +A missing time zone in any format is assumed to be +.BR GMT . +.B String2tm +returns nil if +.I s +is not correctly formed. .SH SOURCE .B /appl/lib/daytime.b .SH SEE ALSO |