summaryrefslogtreecommitdiff
path: root/reference/C/MAN/asctime.htm
diff options
context:
space:
mode:
authorTobias Klauser <tklauser@distanz.ch>2008-01-27 11:37:44 +0100
committerTobias Klauser <tklauser@xenon.tklauser.home>2008-01-27 11:37:44 +0100
commit7e0f021a9aec35fd8e6725e87e3313b101d26f5e (patch)
treeb1cacc4b24393f517aeb4610e9e1021f954307a8 /reference/C/MAN/asctime.htm
Initial import (2.0.2-6)2.0.2-6
Diffstat (limited to 'reference/C/MAN/asctime.htm')
-rw-r--r--reference/C/MAN/asctime.htm233
1 files changed, 233 insertions, 0 deletions
diff --git a/reference/C/MAN/asctime.htm b/reference/C/MAN/asctime.htm
new file mode 100644
index 0000000..d40f4cb
--- /dev/null
+++ b/reference/C/MAN/asctime.htm
@@ -0,0 +1,233 @@
+<TITLE>asctime</TITLE>
+<body bgcolor="#ffffcc">
+<hr>
+<pre>
+
+
+
+<h3>CTIME(3) Linux Programmer's Manual CTIME(3)
+</h3>
+
+<h3>NAME
+</h3> asctime, ctime, gmtime, localtime, mktime - transform
+ binary date and time to ASCII
+
+<h3>SYNOPSIS
+</h3> #include &lt;time.h&gt;
+
+ char *asctime(const struct tm *timeptr);
+
+ char *ctime(const time_t *timep);
+
+ struct tm *gmtime(const time_t *timep);
+
+ struct tm *localtime(const time_t *timep);
+
+ time_t mktime(struct tm *timeptr);
+
+ extern char *tzname[2];
+ long int timezone;
+ extern int daylight;
+
+<h3>DESCRIPTION
+</h3> The ctime(), gmtime() and localtime() functions all take
+ an argument of data type time_t which represents calendar
+ time. When interpreted as an absolute time value, it rep-
+ resents the number of seconds elapsed since 00:00:00 on
+ January 1, 1970, Coordinated Universal Time (UTC).
+
+ The asctime() and mktime() functions both take an argument
+ representing broken-down time which is a binary represen-
+ tation separated into year, month, day, etc. Broken-down
+ time is stored in the structure tm which is defined in
+ &lt;time.h&gt; as follows:
+
+ struct tm
+ {
+ int tm_sec; /* seconds */
+ int tm_min; /* minutes */
+ int tm_hour; /* hours */
+ int tm_mday; /* day of the month */
+ int tm_mon; /* month */
+ int tm_year; /* year */
+ int tm_wday; /* day of the week */
+ int tm_yday; /* day in the year */
+ int tm_isdst; /* daylight saving time */
+ };
+
+ The members of the tm structure are:
+
+ tm_sec The number of seconds after the minute, normally in
+ the range 0 to 59, but can be up to 61 to allow for
+ leap seconds.
+
+ tm_min The number of minutes after the hour, in the range
+
+
+
+<h3>BSD June 30, 1993 1
+</h3>
+
+
+
+
+<h3>CTIME(3) Linux Programmer's Manual CTIME(3)
+</h3>
+
+ 0 to 59.
+
+ tm_hour
+ The number of hours past midnight, in the range 0
+ to 23.
+
+ tm_mday
+ The day of the month, in the range 1 to 31.
+
+ tm_mon The number of months since January, in the range 0
+ to 11.
+
+ tm_year
+ The number of years since 1900.
+
+ tm_wday
+ The number of days since Sunday, in the range 0 to
+ 6.
+
+ tm_yday
+ The number of days since January 1, in the range 0
+ to 365.
+
+ tm_isdst
+ A flag that indicates whether daylight saving time
+ is in effect at the time described. The value is
+ positive if daylight saving time is in effect, zero
+ if it is not, and negative if the information is
+ not available.
+
+ The ctime() function converts the calendar time timep into
+ a string of the form
+
+ "Wed Jun 30 21:49:08 1993\n"
+
+ The abbreviations for the days of the week are `Sun',
+ `Mon', `Tue', `Wed', `Thu', `Fri', and `Sat'. The abbre-
+ viations for the months are `Jan', `Feb', `Mar', `Apr',
+ `May', `Jun', `Jul', `Aug', `Sep', `Oct', `Nov', and
+ `Dec'. The return value points to a statically allocated
+ string which might be overwritten by subsequent calls to
+ any of the date and time functions. The function also
+ sets the external variable tzname with information about
+ the current time zone.
+
+ The gmtime() function converts the calendar time timep to
+ broken-down time representation, expressed in Coordinated
+ Universal Time (UTC).
+
+ The localtime() function converts the calendar time timep
+ to broken-time representation, expressed relative to the
+ user's specified time zone. The function sets the
+ external variables tzname with information about the cur-
+ rent time zone, timezone with the difference between
+
+
+
+<h3>BSD June 30, 1993 2
+</h3>
+
+
+
+
+<h3>CTIME(3) Linux Programmer's Manual CTIME(3)
+</h3>
+
+ Coordinated Universal Time (UTC) and local standard time
+ in seconds, and daylight to a non-zero value if standard
+ US daylight savings time rules apply.
+
+ The asctime() function converts the broken-down time value
+ timeptr into a string with the same format as ctime().
+ The return value points to a statically allocated string
+ which might be overwritten by subsequent calls to any of
+ the date and time functions.
+
+ The mktime() function converts a broken-down time struc-
+ ture to calendar time representation. The function
+ ignores the specified contents of the structure members
+ tm_wday and tm_yday and recomputes them from the other
+ information in the broken-down time structure. Calling
+ mktime() also sets the external variable tzname with
+ information about the current time zone. If the specified
+ broken-down time cannot be represented as calendar time,
+ mktime() returns a value of (time_t)(-1) and does not
+ alter the tm_wday and tm_yday members of the broken-down
+ time structure.
+
+<h3>CONFORMING TO
+</h3> SVID 3, POSIX, BSD 4.3, ISO 9899
+
+</pre>
+<hr>
+<h3>SEE ALSO
+</h3><p>
+<a href=date.htm>date</a>,
+<a href=gettimeofday.htm>gettimeofday</a>,
+<a href=time.htm>time</a>,
+<a href=tzset.htm>tzset</a>,
+<a href=difftime.htm>difftime</a>,
+<a href=strftime.htm>strftime</a>,
+<pre>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h3>BSD June 30, 1993 3
+</h3>
+
+ </pre>
+<P>
+<hr>
+<p>
+<center>
+<table border=2 width=80%>
+<tr align=center>
+<td width=25%>
+<a href=../cref.html>Top</a>
+</td><td width=25%>
+<a href=../master_index.html>Master Index</a>
+</td><td width=25%>
+<a href=../SYNTAX/keywords.html>Keywords</a>
+</td><td width=25%>
+<a href=../FUNCTIONS/funcref.htm>Functions</a>
+</td>
+</tr>
+</table>
+</center>
+<p>
+<hr>
+
+This manual page was brought to you by <i>mjl_man V-2.0</i>