函数
<ctime>

asctime

char* asctime (const struct tm * timeptr);
将 tm 结构转换为字符串
解释由 timeptr 指向的 tm 结构的内容，并将其转换为一个 C 字符串，其中包含该日期和时间的易读版本。

返回的字符串格式如下：

Www Mmm dd hh:mm:ss yyyy


其中 Www 是星期几，Mmm 是月份（字母表示），dd 是月份中的第几天，hh:mm:ss 是时间，yyyy 是年份。

字符串后跟一个换行符（'\n'）并以空字符终止。

其行为定义为等同于：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
char* asctime(const struct tm *timeptr)
{
  static const char wday_name[][4] = {
    "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"
  };
  static const char mon_name[][4] = {
    "Jan", "Feb", "Mar", "Apr", "May", "Jun",
    "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
  };
  static char result[26];
  sprintf(result, "%.3s %.3s%3d %.2d:%.2d:%.2d %d\n",
    wday_name[timeptr->tm_wday],
    mon_name[timeptr->tm_mon],
    timeptr->tm_mday, timeptr->tm_hour,
    timeptr->tm_min, timeptr->tm_sec,
    1900 + timeptr->tm_year);
  return result;
}

对于自定义日期格式的替代方法，请参阅 strftime。

参数

timeptr
指向一个 tm 结构体的指针，该结构体包含一个分解为其各组成部分的日历时间（请参见 struct tm）。

返回值

一个 C 字符串，包含易读格式的日期和时间信息。

返回的值指向一个内部数组，其有效性或值可能会被后续对 asctime 或 ctime 的任何调用所更改。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
 
/* asctime example */
#include <stdio.h>      /* printf */
#include <time.h>       /* time_t, struct tm, time, localtime, asctime */

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;

  time ( &rawtime );
  timeinfo = localtime ( &rawtime );
  printf ( "The current date/time is: %s", asctime (timeinfo) );

  return 0;
}

输出

The current date/time is: Wed Feb 13 15:46:11 2013


数据竞争

该函数访问 timeptr 所指向的对象。
该函数还会访问并修改一个共享的内部缓冲区，这可能导致对 asctime 或 ctime 的并发调用发生数据竞争。某些库提供了避免这种数据竞争的替代函数：asctime_r（不可移植）。

异常 (C++)

无异常保证：此函数从不抛出异常。

另见

ctime
将 time_t 值转换为字符串 (函数)
gmtime
将 time_t 转换为 UTC 时间的 tm (函数)
localtime
将 time_t 转换为本地时间的 tm (函数)
time
获取当前时间 (函数)