asctime
Defined in header <time.h>
|
||
char* asctime( const tm* time_ptr ); |
||
Converts given calendar time tm to a textual representation. The resulting string has the following format:
Www Mmm dd hh:mm:ss yyyy
Www
- the day of the week (one ofMon
,Tue
,Wed
,Thu
,Fri
,Sat
,Sun
).Mmm
- the month (one ofJan
,Feb
,Mar
,Apr
,May
,Jun
,Jul
,Aug
,Sep
,Oct
,Nov
,Dec
).dd
- the day of the monthhh
- hoursmm
- minutesss
- secondsyyyy
- years
The function does not support localization.
Contents |
Parameters
time_ptr | - | pointer to a tm object specifying the time to print |
Return value
pointer to a static null-terminated character string holding the textual representation of date and time. The string may be shared between asctime
and ctime, and may be overwritten on each invocation of any of those functions.
Notes
This function returns a pointer to static data and is not thread-safe. POSIX marks this function obsolete and recommends strftime instead.
The behavior is undefined if the output string would be longer than 25 characters, if timeptr->tm_wday
or timeptr->tm_mon
are not within the expected ranges, or if timeptr->tm_year
exceeds INT_MAX-1990.
Some implementations handle timeptr->tm_mday==0 as meaning the last day of the preceding month.
Example
This section is incomplete Reason: no example |
See also
C++ documentation for asctime
|