diff options
Diffstat (limited to 'man/man3/ctime.html')
| -rw-r--r-- | man/man3/ctime.html | 150 |
1 files changed, 150 insertions, 0 deletions
diff --git a/man/man3/ctime.html b/man/man3/ctime.html new file mode 100644 index 00000000..4c162391 --- /dev/null +++ b/man/man3/ctime.html @@ -0,0 +1,150 @@ +<head> +<title>ctime(3) - Plan 9 from User Space</title> +<meta content="text/html; charset=utf-8" http-equiv=Content-Type> +</head> +<body bgcolor=#ffffff> +<table border=0 cellpadding=0 cellspacing=0 width=100%> +<tr height=10><td> +<tr><td width=20><td> +<tr><td width=20><td><b>CTIME(3)</b><td align=right><b>CTIME(3)</b> +<tr><td width=20><td colspan=2> + <br> +<p><font size=+1><b>NAME </b></font><br> + +<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + ctime, localtime, gmtime, asctime, tm2sec, timezone – convert date + and time<br> + +</table> +<p><font size=+1><b>SYNOPSIS </b></font><br> + +<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + <tt><font size=+1>#include <u.h><br> + #include <libc.h> + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + </font></tt> + <tt><font size=+1>char* ctime(long clock) + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + </font></tt> + <tt><font size=+1>Tm* localtime(long clock) + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + </font></tt> + <tt><font size=+1>Tm* gmtime(long clock) + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + </font></tt> + <tt><font size=+1>char* asctime(Tm *tm) + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + </font></tt> + <tt><font size=+1>long tm2sec(Tm *tm)<br> + </font></tt> +</table> +<p><font size=+1><b>DESCRIPTION </b></font><br> + +<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + <i>Ctime</i> converts a time <i>clock</i> such as returned by <a href="../man3/time.html"><i>time</i>(3)</a> into ASCII + (sic) and returns a pointer to a 30-byte string in the following + form. All the fields have constant width. + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + + + <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + + <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + <tt><font size=+1>Wed Aug 5 01:07:47 EST 1973\n\0 + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + </font></tt> + + </table> + + </table> + <i>Localtime</i> and <i>gmtime</i> return pointers to structures containing + the broken-down time. <i>Localtime</i> corrects for the time zone and + possible daylight savings time; <i>gmtime</i> converts directly to GMT. + <i>Asctime</i> converts a broken-down time to ASCII and returns a pointer + to a 30-byte string.<br> + + <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + <tt><font size=+1>typedef<br> + struct {<br> + + <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + int sec; /* seconds (range 0..59) */<br> + int min; /* minutes (0..59) */<br> + int hour; /* hours (0..23) */<br> + int mday; /* day of the month (1..31) */<br> + int mon; /* month of the year (0..11) */<br> + int year; /* year A.D. – 1900 */<br> + int wday; /* day of week (0..6, Sunday = 0) */<br> + int yday; /* day of year (0..365) */<br> + char zone[4]; /* time zone name */<br> + int tzoff; /* time zone delta from GMT */<br> + + </table> + } Tm;<br> + + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + </font></tt> + + </table> + <i>Tm2sec</i> converts a broken-down time to seconds since the start + of the epoch. It ignores <tt><font size=+1>wday</font></tt>, and assumes the local time zone + if <tt><font size=+1>zone</font></tt> is not <tt><font size=+1>GMT</font></tt>.<br> + +</table> +<p><font size=+1><b>SOURCE </b></font><br> + +<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + <tt><font size=+1>/usr/local/plan9/src/lib9/date.c<br> + /usr/local/plan9/src/lib9/ctime.c<br> + </font></tt> +</table> +<p><font size=+1><b>SEE ALSO </b></font><br> + +<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + <a href="../man1/date.html"><i>date</i>(1)</a>, <a href="../man3/time.html"><i>time</i>(3)</a><br> + +</table> +<p><font size=+1><b>BUGS </b></font><br> + +<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> + + The return values point to static data whose content is overwritten + by each call. + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + + Daylight Savings Time is “normal” in the Southern hemisphere. + + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + + These routines are not equipped to handle non-ASCII text, and + are provincial anyway. + <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> + + To avoid name conflicts with the underlying system, <i>ctime</i>, <i>localtime</i>, + <i>gmtime</i>, <i>asctime</i>, and <i>tm2sec</i> are preprocessor macros defined as + <i>p9ctime</i>, <i>p9localtime</i>, <i>p9gmtime</i>, <i>p9asctime</i>, and <i>p9tm2sec</i>; see <a href="../man3/intro.html"><i>intro</i>(3)</a>.<br> + +</table> + +<td width=20> +<tr height=20><td> +</table> +<!-- TRAILER --> +<table border=0 cellpadding=0 cellspacing=0 width=100%> +<tr height=15><td width=10><td><td width=10> +<tr><td><td> +<center> +<a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a> +</center> +</table> +<!-- TRAILER --> +</body></html> |