C 语言库函数 - asctime() - C 语言标准库

C 语言标准库函数 char asctime(const struct tm timeptr) 在头文件 <time.h> 中被声明，它返回一个指向字符串的指针，它代表了结构 struct timeptr 的日期和时间

头文件

#include <time.h>

函数原型

下面是 asctime() 函数的原型

char *asctime( const struct tm *timeptr )

参数

timeptr 是一个指向 tm 结构的指针，包含了分解为如下各部分的日期时间

struct tm {
   int tm_sec;         /* 秒，范围从 0 到 59                */
   int tm_min;         /* 分，范围从 0 到 59                */
   int tm_hour;        /* 小时，范围从 0 到 23              */
   int tm_mday;        /* 一月中的第几天，范围从 1 到 31      */
   int tm_mon;         /* 月份，范围从 0 到 11              */
   int tm_year;        /* 自 1900 起的年数                  */
   int tm_wday;        /* 一周中的第几天，范围从 0 到 6       */
   int tm_yday;        /* 一年中的第几天，范围从 0 到 365     */
   int tm_isdst;       /* 夏令时                           */    
};

返回值

asctime() 函数返回一个 C 字符串，包含了可读格式的日期和时间信息 Www Mmm dd hh:mm:ss yyyy 。

Www 表示星期几
Mmm 是以字母表示的月份
dd 表示一月中的第几天
hh:mm:ss 表示时间
yyyy 表示年份

范例

下面的范例演示了 asctime() 函数的用法

/**
 * file: main.c
 * author: 简单教程(www.twle.cn)
 *
 * Copyright © 2015-2065 www.twle.cn. All rights reserved.
 */

#include <stdio.h>
#include <string.h>
#include <time.h>

int main()
{
   struct tm t;

   t.tm_sec    = 10;
   t.tm_min    = 13;
   t.tm_hour   = 21;
   t.tm_mday   = 25;
   t.tm_mon    = 9;
   t.tm_year   = 2017;

   puts(asctime(&t));

   return(0);
}

编译和运行以上范例，输出结果如下

$ gcc main.c && ./a.out
Sun Oct 25 21:13:10 3917