C标准库学习tim.h

<time.h>
 
NULL
    Null pointer constant.

clock_t  //一个描述时间流逝的数学类型long
    An arithmetic type elapsed processor representing time.

time_t
    An arithmetic type representing calendar time.
    描述日历时间的类型long, 表示从一个时间点（例如：1970年1月1日0时0分0秒）到此时的秒数

struct tm  // 描述日历时间组成部分的结构
    Represents the components of calendar time:
    struct tm {
        int tm_sec;     /* seconds after the minute - [0,59] */
        int tm_min;     /* minutes after the hour - [0,59] */
        int tm_hour;    /* hours since midnight - [0,23] */
        int tm_mday;    /* day of the month - [1,31] */
        int tm_mon;     /* months since January - [0,11] */
        int tm_year;    /* years since 1900 */
        int tm_wday;    /* days since Sunday - [0,6] */
        int tm_yday;    /* days since January 1 - [0,365] */
        int tm_isdst;   /* daylight savings time flag */
        };.
 
#define CLOCKS_PER_SEC  1000 //1秒钟有多少个时钟计时单元

clock_t clock(void);
    Returns elapsed processor time used by program or -1 if not available.
    返回从“开启这个程序进程”到“程序中调用clock()函数”时之间的CPU时钟计时单元（clock

tick）数

time_t time(time_t* tp);
    返回当前的日历时间或者-1。如果tp非空，返回值将复制到tp。

double difftime(time_t time2, time_t time1);
    返回time2, time1间的秒数.

time_t mktime(struct tm* tp);
    If necessary, adjusts fields of *tp to fall withing normal ranges. Returns the

corresponding calendar time, or -1 if it cannot be represented.

char* asctime(const struct tm* tp);
    返回给定时间的如下格式的字符串:
    Sun Jan 3 13:08:42 1988/n/0

char* ctime(const time_t* tp);
    Returns string equivalent to calendar time tp converted to local time. Equivalent to:
    asctime(localtime(tp))

struct tm* gmtime(const time_t* tp);
    Returns calendar time *tp converted to Coordinated Universal Time, or NULL if not

available.

struct tm* localtime(const time_t* tp);
    常用的获取当前时间函数.

size_t strftime(
char *strDest,
size_t maxsize,
const char *format,
const struct tm *timeptr
);
 
 
 
我们可以根据format指向字符串中格式命令把timeptr中保存的时间信息放在strDest指向的字符串中，最多向strDest中存放maxsize个字符。该函数返回向strDest指向的字符串中放置的字符数。

函数strftime()的操作有些类似于sprintf()：识别以百分号(%)开始的格式命令集合，格式化输出结果放在一个字符串中。格式化命令说明串strDest中各种日期和时间信息的确切表示方法。格式串中的其他字符原样放进串中。格式命令列在下面，它们是区分大小写的。

%a 星期几的简写
%A 星期几的全称
%b 月分的简写
%B 月份的全称
%c 标准的日期的时间串
%C 年份的后两位数字
%d 十进制表示的每月的第几天
%D 月/天/年
%e 在两字符域中，十进制表示的每月的第几天
%F 年-月-日
%g 年份的后两位数字，使用基于周的年
%G 年分，使用基于周的年
%h 简写的月份名
%H 24小时制的小时
%I 12小时制的小时
%j 十进制表示的每年的第几天
%m 十进制表示的月份
%M 十时制表示的分钟数
%n 新行符
%p 本地的AM或PM的等价显示
%r 12小时的时间
%R 显示小时和分钟：hh:mm
%S 十进制的秒数
%t 水平制表符
%T 显示时分秒：hh:mm:ss
%u 每周的第几天，星期一为第一天 （值从0到6，星期一为0）
%U 第年的第几周，把星期日做为第一天（值从0到53）
%V 每年的第几周，使用基于周的年
%w 十进制表示的星期几（值从0到6，星期天为0）
%W 每年的第几周，把星期一做为第一天（值从0到53）
%x 标准的日期串
%X 标准的时间串
%y 不带世纪的十进制年份（值从0到99）
%Y 带世纪部分的十进制年份
%z，%Z 时区名称，如果不能得到时区名称则返回空字符。
%% 百分号 

例：
1.用clock函数来计算你的机器运行一个循环或者处理其它事件到底花了多少时间：
#include “stdio.h”
#include “stdlib.h”
#include “time.h”
int main( void )
{
long i = 10000000L;
clock_t start, finish;
double duration;
/* 测量一个事件持续的时间*/
printf( "Time to do %ld empty loops is ", i );
start = clock();
while( i-- ) ;
finish = clock();
duration = (double)(finish - start) / CLOCKS_PER_SEC;
printf( "%f seconds/n", duration );
system("pause");
} 

2.显示当前的日历时间：

#include "time.h"
#include "stdio.h"
int main(void)
{
struct tm *ptr;
time_t lt;
lt =time(NUL);
printf("The Calendar Time now is %d/n",lt);
return 0;
} 

3.gmtime()函数是将日历时间转化为世界标准时间（即格林尼治时间），并返回一个tm结构体来保存这个时间，而localtime()函数是将日历时间转化为本地时间。比如现在用gmtime()函数获得的世界标准时间是2005年7月30日7点18分20秒，那么我用localtime()函数在中国地区获得的本地时间会比世界标准时间晚8个小时，即2005年7月30日15点18分20秒。下面是个例子：

#include "time.h"
#include "stdio.h"
int main(void)
{
struct tm *local;
time_t t;
t=time(NUL);
local=localtime(&t);
printf("Local hour is: %d/n",local->tm_hour);
local=gmtime(&t);
printf("UTC hour is: %d/n",local->tm_hour);
return 0;
} 

4.我们可以通过asctime()函数和ctime()函数将时间以固定的格式显示出来，两者的返回值都是char*型的字符串。返回的时间格式为：

星期几 月份 日期 时:分:秒 年/n/0
例如：Wed Jan 02 02:03:55 1980/n/0

其中/n是一个换行符，/0是一个空字符，表示字符串结束。下面是两个函数的原型：

char * asctime(const struct tm * timeptr);
char * ctime(const time_t *timer);

其中asctime()函数是通过tm结构来生成具有固定格式的保存时间信息的字符串，而ctime()是通过日历时间来生成时间字符串。这样的话，asctime（）函数只是把tm结构对象中的各个域填到时间字符串的相应位置就行了，而ctime（）函数需要先参照本地的时间设置，把日历时间转化为本地时间，然后再生成格式化后的字符串。在下面，如果t是一个非空的time_t变量的话，那么：

printf(ctime(&t));

等价于：

struct tm *ptr;
ptr=localtime(&t);
printf(asctime(ptr));

那么，下面这个程序的两条printf语句输出的结果就是不同的了（除非你将本地时区设为世界标准时间所在的时区）：

#include "time.h"
#include "stdio.h"
int main(void)
{
struct tm *ptr;
time_t lt;
lt =time(NUL);
ptr=gmtime(<);
printf(asctime(ptr));
printf(ctime(<));
return 0;
}

运行结果：

Sat Jul 30 08:43:03 2005
Sat Jul 30 16:43:03 2005