time.h 详细操作指南

2009-12-09 20:54

time.h

有人总结成这么几句，的确是经典，自己好好编程试试效果吧，

两个类型：

time_t：表示距离 UTC 时间 1970-01-01 00:00:00 的秒数。也叫做日历时。
struct tm：通常用于存储本地时。
几个函数：

time：获取当前系统时间（UTC时间）的time_t值。

ctime：将time_t值转换为表示本地时间的字符串。
gmttime：将time_t值转换为表示GMT时间的字符串。

localtime：将time_t转换为表示本地时间的strunct tm结构。
mktime：将表示本地时间的struct tm转换为time_t。
asctime：将struct tm转换为字符串形式。
difftime：得到两个日历时之间的差值。

========================================================================
@函数名称:     localtime
函数原型:    struct tm *localtime(const time_t *timer)
函数功能:     返回一个以tm结构表达的机器时间信息
函数返回:     以tm结构表达的时间，结构tm定义如下:
struct   tm{
int tm_sec;
int tm_min;
int tm_hour;
int tm_mday;
int tm_mon;
int tm_year;
int tm_wday;
int tm_yday;
int tm_isdst;
};
参数说明:     timer-使用time()函数获得的机器时间
所属文件:     <time.h>

#include <time.h>
#include <stdio.h>
#include <dos.h>
int main()
{
time_t timer;
struct tm *tblock;
timer=time(NULL);
tblock=localtime(&timer);
printf("Local time is: %s",asctime(tblock));
return 0;
}


@函数名称:     asctime
函数原型:    char* asctime(struct tm * ptr)
函数功能:     得到机器时间(日期时间转换为ASCII码)
函数返回:     返回的时间字符串格式为：星期,月,日,小时：分：秒,年
参数说明:     结构指针ptr应通过函数localtime()和gmtime()得到
所属文件:     <time.h>

#include <stdio.h>
#include <string.h>
#include <time.h>
int main()
{
struct tm t;
char str[80];
t.tm_sec=1;
t.tm_min=3;
t.tm_hour=7;
t.tm_mday=22;
t.tm_mon=11;
t.tm_year=56;
t.tm_wday=4;
t.tm_yday=0;
t.tm_isdst=0;
strcpy(str,asctime(&t));
printf("%s",str);
return 0;
}


@函数名称:     ctime
函数原型:    char *ctime(long time)
函数功能:     得到日历时间
函数返回:     返回字符串格式：星期,月,日,小时:分:秒,年
参数说明:     time-该参数应由函数time获得
所属文件:     <time.h>

#include <stdio.h>
#include <time.h>
int main()
{
time_t t;
time(&t);
printf("Today's date and time: %s",ctime(&t));
return 0;
}


@函数名称:     difftime
函数原型:    double difftime(time_t time2, time_t time1)
函数功能:     得到两次机器时间差，单位为秒
函数返回:     时间差，单位为秒
参数说明:     time1-机器时间一,time2-机器时间二.该参数应使用time函数获得
所属文件:     <time.h>

#include <time.h>
#include <stdio.h>
#include <dos.h>
#include <conio.h>
int main()
{
time_t first, second;
clrscr();
first=time(NULL);
delay(2000);
second=time(NULL);
printf("The difference is: %f seconds",difftime(second,first));
getch();
return 0;
}


@函数名称:     gmtime
函数原型:    struct tm *gmtime(time_t   *time)
函数功能:     得到以结构tm表示的时间信息
函数返回:     以结构tm表示的时间信息指针
参数说明:     time-用函数time()得到的时间信息
所属文件:     <time.h>

#include <stdio.h>
#include <stdlib.h>
#include <time.h>
#include <dos.h>
char *tzstr="TZ=PST8PDT";
int main()
{
time_t t;
struct tm *gmt, *area;
putenv(tzstr);
tzset();
t=time(NULL);
area=localtime(&t);
printf("Local time is:%s", asctime(area));
gmt=gmtime(&t);
printf("GMT is:%s", asctime(gmt));
return 0;
}


@函数名称:     time
函数原型:     time_t time(time_t *timer)
函数功能:     得到机器的日历时间或者设置日历时间
函数返回:     机器日历时间
参数说明:     timer=NULL时得到机器日历时间，timer=时间数值时，用于设置日历时间，time_t是一个long类型
所属文件:     <time.h>

#include <time.h>
#include <stdio.h>
#include <dos.h>
int main()
{
time_t t;
t=time();
printf("The number of seconds since January 1,1970 is %ld",t);
return 0;
}


@函数名称:     tzset
函数原型:    void tzset(void)
函数功能:     UNIX兼容函数，用于得到时区，在DOS环境下无用途
函数返回:
参数说明:
所属文件:     <time.h>

#include <time.h>
#include <stdlib.h>
#include <stdio.h>
int main()
{
time_t td;
putenv("TZ=PST8PDT");
tzset();
time(&td);
printf("Current time=%s",asctime(localtime(&td)));
return 0;
}

=================================================================================

1.Coordinated Universal Time(UTC)：协调世界时，又称世界标准时间，也即格林威治标准时间(Greenwich Mean Time,GMT)，中国内地的时间与UTC得时差为+8，也即UTC+8，美国为UTC-5。
2.Calendar Time：日历时间，是用“从一个标准时间点到此时的时间经过的秒数”来表示的时间。标准时间点对不同编译器可能会不同，但对一个编译系统来说，标准时间是不变的。
3.epoch：时间点。在标准c/c++中是一个整数，用此时的时间和标准时间点相差的秒数（即日历时间）来表示
4.clock tick：时钟计时单元（而不叫做时钟滴答次数），一个时钟计时单元的时间长短是由cpu控制的，一个clock tick不是cpu的一个时钟周期，而是c/c++的一个基本计时单位。
5.计时函数：clock_t clock(void);//返回值：从“开启这个程序进程”到“程序中调用clock（）函数”时之间的cpu时钟计时单元（clock tick）数，MSDN中称为挂钟时间（wal-clock），其中
//time.h
#ifndef _CLOCK_T_DEFINED
typedef long clock_t;
#define _CLOCK_T_DEFINED
#endif
//time.h
#define CLOCKS_PER_SEC ((clock_t)1000) //CLOCK_PER_SEC表示一秒会有多少个时钟计时单元，标准c/c++中，最小的计时单位是一毫秒，可通过clock()/CLOCK_T_SEC得到进程自身运行时间
6.存储时间和日期的数据结构tm：
//time.h
#ifndef _TM_DEFINED
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;//从每年的1月1日开始计数，[0-365]
int tm_isdst;//夏令标识符，实行夏令时，tm_isdst为正；不实行夏令时，tm_isdst为0；不了解情况时，tm_isdst为负
}；
#define _TM_DEFINED
#endif
7.日历时间用time_t存储：
//time.h
#ifndef _TIME_T_DEFINED
typedef long time_t;
#define _TIME_T_DEFINED
#endif
使用time_t表示的日历时间只能存储到2038年1月18日19时14分07秒，为了能表示更久远的时间，一些编译器引入了64位甚至更长的整形数保 存日历时间，如VC中采用_time64_t数据类型，通过_time64()函数获得日历时间（不是32位的time()）这样可以计算3001年1月 1日0时0分0秒（不包括该时间点）之前的时间

8.可以使用ANSI的标准库中的time.h头文件，其中定义了时间和日期所使用的方法，在time.h头文件中，我们还可以看到一些函数，它们都是以time_t为参数类型或返回值类型的函数：
double difftime（time_t time1， time_t time0）；//精确到秒,
time_t mktime（struct tm * timeptr）；//用tm结构表示的时间转化为日历时间，返回值就是转化后的日历时间，在1970年1月1日之前的时间，很多编译器虽然能通过，但运行会异常终止
time_t time（time_t * timer）；//获得从一个时间点到现在的日历时间（Calendar Time）
char * asctime（const struct tm * timeptr）；//按固定格式显示时间，返回的时间格式为：星期几 月份 日期 时：分：秒 年\n\0；其中\n是换行符，\0表示字符串结束，直接将tm结构体内容按格式转换
char * ctime（const time_t *timer）；//按固定格式显示时间，返回的时间格式为：星期几 月份 日期 时：分：秒 年\n\0；其中\n是换行符，\0表示字符串结束，将日历时间转化为本地时间，再生成格式化字符串
此外，time.h还提供了两种不同的函数将日历时间（一个用time_t表示的整数）转换为我们平时看到的把年月日时分秒分开显示的时间格式tm：
struct tm * gmtime（const time_t *timer）；//将日历时间转化为标准时间，返回tm结构体保存这个时间，其中timer可用time()返回的值
struct tm * localtime（const time_t * timer）；//将日历时间转化为本地时间，其中timer可用time()返回的值
通过查阅MSDN，我们可以知道Microsoft C/C++ 7.0中时间点的值（time_t对象的值）是从1899年12月31日0时0分0秒到该时间点所经过的秒数，而其它各种版本的Microsoft C/C++和所有不同版本的Visual C++都是计算的从1970年1月1日0时0分0秒到该时间点所经过的秒数。
8.自定义时间格式：使用strftime（）函数将时间格式化为我们想要的格式
size_t strftime(char *strDest,size_t maxsize，const char *format,const struct tm *timeptr);//根据format指向字符串中格式命令把timeptr中保存的时间信息放在strDest指向的字符串中，最多向 strDest中存放maxsize个字符。该函数返回向strDest指向的字符串中放置的字符数。类似于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 时区名称，如果不能得到时区名称则返回空字符。
%% 百分号
如：
#include <stdio.h>
#include <time.h>
void main( void )
{
struct tm *newtime;
char tmpbuf[128];
time_t lt1;
time( &lt1 );
newtime=localtime(&lt1);
strftime( tmpbuf, 128, "Today is %A, day %d of %B in the year %Y.\n", newtime);
printf(tmpbuf);
}
运行结果：
Today is Saturday， day 30 of July in the year 2005.

http://hi.baidu.com/shallfun/blog/item/924d8f2ba21ad027d52af160.html