ansitime.html

vxworks相关论文

</blockquote><h1><i>gmtime_r</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>gmtime_r</i>(&nbsp;)</strong> - convert calendar time into broken-down time (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int gmtime_r
    (
    const time_t * timer,     /* calendar time in seconds */
    struct tm *    timeBuffer /* buffer for broken down time */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine converts the calendar time pointed to by <i>timer</i> into
broken-down time, expressed as Coordinated Universal Time (UTC).
The broken-down time is stored in <i>timeBuffer</i>.
<p>
This routine is the POSIX re-entrant version of <b><i><a href="./ansiTime.html#gmtime">gmtime</a></i>(&nbsp;)</b>.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>time.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiTime.html#top">ansiTime</a></b>

<hr>
<a name="localtime"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>localtime</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>localtime</i>(&nbsp;)</strong> - convert calendar time into broken-down time (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>struct tm *localtime
    (
    const time_t * timer /* calendar time in seconds */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine converts the calendar time pointed to by <i>timer</i> into
broken-down time, expressed as local time.
<p>
This routine is not reentrant.  For a reentrant version, see <b><i><a href="./ansiTime.html#localtime_r">localtime_r</a></i>(&nbsp;)</b>.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>time.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
A pointer to a <b>tm</b> structure containing the local broken-down time.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiTime.html#top">ansiTime</a></b>

<hr>
<a name="localtime_r"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>localtime_r</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>localtime_r</i>(&nbsp;)</strong> - convert calendar time into broken-down time (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int localtime_r
    (
    const time_t * timer,     /* calendar time in seconds */
    struct tm *    timeBuffer /* buffer for the broken-down time */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine converts the calendar time pointed to by <i>timer</i> into
broken-down time, expressed as local time.  The broken-down time is
stored in <i>timeBuffer</i>.
<p>
This routine is the POSIX re-entrant version of <b><i><a href="./ansiTime.html#localtime">localtime</a></i>(&nbsp;)</b>.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>time.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiTime.html#top">ansiTime</a></b>

<hr>
<a name="mktime"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>mktime</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>mktime</i>(&nbsp;)</strong> - convert broken-down time into calendar time (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>time_t mktime
    (
    struct tm * timeptr /* pointer to broken-down structure */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine converts the broken-down time, expressed as local time, in
the structure pointed to by <i>timeptr</i> into a calendar time value with the
same encoding as that of the values returned by the <b><i><a href="./ansiTime.html#time">time</a></i>(&nbsp;)</b> function.  The
original values of the <b>tm_wday</b> and <b>tm_yday</b> components of the <b>tm</b>
structure are ignored, and the original values of the other components are
not restricted to the ranges indicated in <b>time.h</b>.  On successful completion,
the values of <b>tm_wday</b> and <b>tm_yday</b> are set appropriately, and the other
components are set to represent the specified calendar time, but with
their values forced to the ranges indicated in <b>time.h</b>; the final value of
<b>tm_mday</b> is not set until <b>tm_mon</b> and <b>tm_year</b> are determined.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>time.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The calendar time in seconds, or ERROR (-1)
if calendar time cannot be calculated.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiTime.html#top">ansiTime</a></b>

<hr>
<a name="strftime"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>strftime</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>strftime</i>(&nbsp;)</strong> - convert broken-down time into a formatted string (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>size_t strftime
    (
    char *            s,      /* string array */
    size_t            n,      /* maximum size of array */
    const char *      format, /* format of output string */
    const struct tm * tptr    /* broken-down time */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine formats the broken-down time in <i>tptr</i> based on the conversion
specified in the string <i>format</i>, and places the result in the string <i>s</i>.
<p>
The format is a multibyte character sequence, beginning and ending in its
initial state.  The <i>format</i> string consists of zero or more conversion
specifiers and ordinary multibyte characters.  A conversion specifier
consists of a % character followed by a character that determines the
behavior of the conversion.  All ordinary multibyte characters (including
the terminating NULL character) are copied unchanged to the array.  If
copying takes place between objects that overlap, the behavior is
undefined.  No more than <i>n</i> characters are placed into the array.
<p>
Each conversion specifier is replaced by appropriate characters as 
described in the following list.  The appropriate characters are determined 
by the <b>LC_TIME</b> category of the current locale and by the values contained 
in the structure pointed to by <i>tptr</i>.
<p>
<dl>
<dt>
%a
<dd>

the locale's abbreviated weekday name.
<p>
<dt>
%A
<dd>

the locale's full weekday name.
<p>
<dt>
%b
<dd>

the locale's abbreviated month name.
<p>
<dt>
%B
<dd>

the locale's full month name.
<p>
<dt>
%c
<dd>

the locale's appropriate date and time representation.
<p>
<dt>
%d
<dd>

the day of the month as decimal number (01-31).
<p>
<dt>
%H
<dd>

the hour (24-hour clock) as a decimal number (00-23).
<p>
<dt>
%I
<dd>

the hour (12-hour clock) as a decimal number (01-12).
<p>
<dt>
%j
<dd>

the day of the year as decimal number (001-366).
<p>
<dt>
%m
<dd>

the month as a decimal number (01-12).
<p>
<dt>
%M
<dd>

the minute as a decimal number (00-59).
<p>
<dt>
%P
<dd>

the locale's equivalent of the AM/PM 
designations associated with a 12-hour clock.
<p>
<dt>
%S
<dd>

the second as a decimal number (00-59).
<p>
<dt>
%U
<dd>

the week number of the year (first Sunday
as the first day of week 1) as a decimal number (00-53).
<p>
<dt>
%w
<dd>

the weekday as a decimal number (0-6), where Sunday is 0.
<p>
<dt>
%W
<dd>

the week number of the year (the first Monday
as the first day of week 1) as a decimal number (00-53).
<p>
<dt>
%x
<dd>

the locale's appropriate date representation.
<p>
<dt>
%X
<dd>

the locale's appropriate time representation.
<p>
<dt>
%y
<dd>

the year without century as a decimal number (00-99).
<p>
<dt>
%Y
<dd>

the year with century as a decimal number.
<p>
<dt>
%Z
<dd>

the time zone name or abbreviation, or by no
characters if no time zone is determinable.
<p>
<dt>
%%
<dd>
 %. 
</dl>

<p>

For any other conversion specifier, the behavior is undefined.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>time.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The number of characters in <i>s</i>, not including the terminating null
character -- or zero if the number of characters in <i>s</i>, including the null
character, is more than <i>n</i> (in which case the contents of <i>s</i> are
indeterminate).
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiTime.html#top">ansiTime</a></b>

<hr>
<a name="time"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>time</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>time</i>(&nbsp;)</strong> - determine the current calendar time (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>time_t time
    (
    time_t * timer /* calendar time in seconds */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the implementation's best approximation of current
calendar time in seconds.  If <i>timer</i> is non-NULL, the return value is
also copied to the location <i>timer</i> points to.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>time.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The current calendar time in seconds, or ERROR (-1) if the calendar time
is not available.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiTime.html#top">ansiTime</a></b>, <b><i><a href="./clockLib.html#clock_gettime">clock_gettime</a></i>(&nbsp;)</b>

</body>
</html>