asctime，_wasctime

将 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

另请参阅

工时管理
ctime、_ctime32、_ctime64、_wctime、_wctime32、_wctime64
_ftime、_ftime32、_ftime64
gmtime、_gmtime32、_gmtime64
localtime、_localtime32、_localtime64
time、_time32、_time64
_tzset
asctime_s、_wasctime_s