%>
将 tm 时间结构转换为字符串。 提供这些函数的更安全版本；请参阅 asctime_s、_wasctime_s。
语法
char *asctime(
const struct tm *timeptr
);
wchar_t *_wasctime(
const struct tm *timeptr
);
参数
timeptr
时间/日期结构。
返回值
asctime 返回一个指向字符串结果的指针；_wasctime 返回一个指向宽字符串结果的指针。 没有错误返回值。
备注
提供这些函数的更安全版本；请参阅 asctime_s、_wasctime_s。
asctime 函数将存储为结构的时间转换为字符串。 通常情况下，timeptr 值通过调用 gmtime 或 localtime 获取，这两个函数均返回一个指向 TIME_H 中定义的 tm 结构的指针。
timeptr 成员 |
值 |
|---|---|
tm_hour |
午夜以后的小时数 (0-23) |
tm_isdst |
如果夏令时生效，则为正；如果夏令时不生效，则为 0；如果夏令时状态未知，则为负。 C 运行时库假设使用美国规则实现夏令时 (DST) 的计算。 |
tm_mday |
月份日期 (1-31) |
tm_min |
整点后的分钟数 (0-59) |
tm_mon |
月（0-11；1 月 = 0） |
tm_sec |
整分后的秒数 (0-59) |
tm_wday |
每周的某一日（0-6；星期天 = 0） |
tm_yday |
一年的某一天（0-365；1 月 1 日 = 0） |
tm_year |
年（当前年份减去 1900） |
有关配置本地时间的信息，请参阅 time、_ftime 和 localtime 函数。 有关定义时区环境和全局变量的信息，请参阅 _tzset 函数。
asctime 生成的字符串结果正好包含 26 个字符，格式为 Wed Jan 2 02:03:55 1980\n\0。 使用 24 小时制。 所有字段都具有固定宽度。 换行符和空字符占据字符串的最后两个位置。 asctime 使用单个静态分配的缓冲区来保存返回的字符串。 每次调用此函数都会破坏上一次调用的结果。
_wasctime 是 asctime 的宽字符版本，否则行为与 asctime 相同。
这些函数验证其参数。 如果 timeptr 是空指针或包含超出范围的值，则调用无效参数处理程序，如参数验证中所述。 如果允许继续执行，则函数将返回 NULL，并且将 errno 设置为 EINVAL。
默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。
一般文本例程映射
TCHAR.H 例程 |
_UNICODE 和 _MBCS 未定义 |
_MBCS 已定义 |
_UNICODE 已定义 |
|---|---|---|---|
_tasctime |
asctime |
asctime |
_wasctime |
要求
| 例程 | 必需的标头 |
|---|---|
asctime |
<time.h> |
_wasctime |
<time.h> 或 <wchar.h> |
示例
此程序以长整型 aclock 格式进行系统时间设置，将其转换为 newtime 结构，然后使用 asctime 函数将其转换为字符串形式以进行输出。
// crt_asctime.c
// compile with: /W3
#include <time.h>
#include <stdio.h>
int main( void )
{
struct tm *newTime;
time_t szClock;
// Get time in seconds
time( &szClock );
// Convert time to struct tm form
newTime = localtime( &szClock );
// Print local time as a string.
printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
// Note: asctime is deprecated; consider using asctime_s instead
}
Current date and time: Sun Feb 3 11:38:58 2002