time函数详解.docx

资源描述

time函数详解.docx

《time函数详解.docx》由会员分享，可在线阅读，更多相关《time函数详解.docx（16页珍藏版）》请在冰豆网上搜索。

time函数详解.docx

time函数详解

time函数time.h

@函数名称:

localtime

函数原型:

structtm*localtime（consttime_t*timer）

函数功能:

返回一个以tm结构表达的机器时间信息

函数返回:

以tm结构表达的时间，结构tm定义如下:

structtm{

inttm_sec;

inttm_min;

inttm_hour;

inttm_mday;

inttm_mon;

inttm_year;

inttm_wday;

inttm_yday;

inttm_isdst;

};

参数说明:

timer-使用time（）函数获得的机器时间

所属文件:

#include

intmain（）

{

time_ttimer;

structtm*tblock;

timer=time（NULL）;

tblock=localtime（&timer）;

printf（"Localtimeis:

%s",asctime（tblock））;

return0;

}

@函数名称:

asctime

函数原型:

char*asctime（structtm*ptr）

函数功能:

得到机器时间（日期时间转换为ASCII码）

函数返回:

返回的时间字符串格式为：

星期,月,日,小时：

分：

秒,年

参数说明:

结构指针ptr应通过函数localtime（）和gmtime（）得到

所属文件:

#include

intmain（）

{

structtmt;

charstr[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）;

return0;

}

@函数名称:

ctime

函数原型:

char*ctime（longtime）

函数功能:

得到日历时间

函数返回:

返回字符串格式：

星期,月,日,小时:

分:

秒,年

参数说明:

time-该参数应由函数time获得

所属文件:

#include

intmain（）

{

time_tt;

time（&t）;

printf（"Today'sdateandtime:

%s",ctime（&t））;

return0;

}

@函数名称:

difftime

函数原型:

doubledifftime（time_ttime2,time_ttime1）

函数功能:

得到两次机器时间差，单位为秒

函数返回:

时间差，单位为秒

参数说明:

time1-机器时间一,time2-机器时间二.该参数应使用time函数获得

所属文件:

#include

intmain（）

{

time_tfirst,second;

clrscr（）;

first=time（NULL）;

delay（2000）;

second=time（NULL）;

printf（"Thedifferenceis:

%fseconds",difftime（second,first））;

getch（）;

return0;

}

@函数名称:

gmtime

函数原型:

structtm*gmtime（time_t*time）

函数功能:

得到以结构tm表示的时间信息

函数返回:

以结构tm表示的时间信息指针

参数说明:

time-用函数time（）得到的时间信息

所属文件:

#include

char*tzstr="TZ=PST8PDT";

intmain（）

{

time_tt;

structtm*gmt,*area;

putenv（tzstr）;

tzset（）;

t=time（NULL）;

area=localtime（&t）;

printf（"Localtimeis:

%s",asctime（area））;

gmt=gmtime（&t）;

printf（"GMTis:

%s",asctime（gmt））;

return0;

}

@函数名称:

time

函数原型:

time_ttime（time_t*timer）

函数功能:

得到机器的日历时间或者设置日历时间

函数返回:

机器日历时间

参数说明:

timer=NULL时得到机器日历时间，timer=时间数值时，用于设置日历时间，time_t是一个long类型

所属文件:

#include

intmain（）

{

time_tt;

t=time（）;

printf（"ThenumberofsecondssinceJanuary1,1970is%ld",t）;

return0;

}

@函数名称:

tzset

函数原型:

voidtzset（void）

函数功能:

UNIX兼容函数，用于得到时区，在DOS环境下无用途

函数返回:

参数说明:

所属文件:

#include

intmain（）

{

time_ttd;

putenv（"TZ=PST8PDT"）;

tzset（）;

time（&td）;

printf（"Currenttime=%s",asctime（localtime（&td）））;

return0;

}

asctime（将时间和日期以字符串格式表示）;===>传入UTC（structtm）tmp，返回char*。

ctime（将时间和日期以字符串格式表示）;===>传入（time_t）arg，返回char*。

gettimeofday（取得目前的时间）;===>传入（time_t）arg，返回tv，tz结构体传入时间，时区信息。

gmtime（取得目前时间和日期）;===>传入（time_t）arg，返回UTC（structtm）tmp。

localtime（取得当地目前时间和日期）;===>传入time_t，返回当地（structtm）tmp。

mktime（将时间结构数据转换成经过的秒数）;===>把（structtm）tmp转换为UTC（time_t）arg。

settimeofday（设置目前时间）;===>通过tv，tz结构体传入时间，时区信息。

time（取得目前的时间）;===>非空参数（或返回值）接收（time_t）arg。

×××注1：

char*是字符串时间格式。

如：

SatOct2802:

10:

062000。

×××注2：

time_t是time（）的返回值类型，（time_t）arg指从1970年到所指时间的秒数。

×××注3：

structtm为真实世界的表示时间方式，（structtm）tmp是指向tm的时间。

×××注4：

UTC,指标准时间。

简单的想，就是0时区的时间标准。

以下是各个函数的详解：

_______________________________________________________________________________

asctime（将时间和日期以字符串格式表示）

相关函数time，ctime，gmtime，localtime

表头文件#include

定义函数char*asctime（conststructtm*timeptr）;

函数说明asctime（）将参数timeptr所指的tm结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回。

此函数已经由时区转换成当地时间，字符串格式为:

“WedJun3021:

49:

081993\n”

返回值若再调用相关的时间日期函数，此字符串可能会被破坏。

此函数与ctime不同处在于传入的参数是不同的结构。

附加说明返回一字符串表示目前当地的时间日期。

范例

#include

intmain（）

{

time_ttimep;

time（&timep）;

printf（“%s”,asctime（gmtime（&timep）））;

return0;

}

执行

SatOct2802:

10:

062000

##############################################################################　

_______________________________________________________________________________

ctime（将时间和日期以字符串格式表示）

相关函数time，asctime，gmtime，localtime

表头文件#include

定义函数char*ctime（consttime_t*timep）;

函数说明ctime（）将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回。

此函数已经由时区转换成当地时间，字符串格式为“WedJun3021:

49:

081993\n”。

若再调用相关的时间日期函数，此字符串可能会被破坏。

返回值返回一字符串表示目前当地的时间日期。

范例

#include

intmain（）{

time_ttimep;

time（&timep）;

printf（“%s”,ctime（&timep））;

return0;

}

执行

SatOct2810:

12:

052000

##############################################################################

_______________________________________________________________________________

gettimeofday（取得目前的时间）

相关函数time，ctime，ftime，settimeofday

表头文件#include

&#include

定义函数intgettimeofday（structtimeval*tv,structtimezone*tz）

函数说明gettimeofday（）会把目前的时间有tv所指的结构返回，当地时区的信息则放到tz所指的结构中。

timeval结构定义为:

structtimeval{

longtv_sec;

longtv_usec;

};

timezone结构定义为:

structtimezone{

inttz_minuteswest;

inttz_dsttime;

};

上述两个结构都定义在/usr/include/sys/time.h。

tz_dsttime所代表的状态如下

DST_NONE

DST_USA

DST_AUST

DST_WET

DST_MET

DST_EET

DST_CAN

DST_GB

DST_RUM

DST_TUR

DST_AUSTALT

返回值成功则返回0，失败返回－1，错误代码存于errno。

附加说明EFAULT指针tv和tz所指的内存空间超出存取权限。

范例

#include

intmain（）{

structtimevaltv;

structtimezonetz;

gettimeofday（&tv,&tz）;

printf（“tv_sec;%d\n”,tv,.tv_sec）;

printf（“tv_usec;%d\n”,tv.tv_usec）;

printf（“tz_minuteswest;%d\n”,tz.tz_minuteswest）;

printf（“tz_dsttime,%d\n”,tz.tz_dsttime）;

return0;

}

执行

tv_sec:

974857339

tv_usec:

136996

tz_minuteswest:

-540

tz_dsttime:

##############################################################################

_______________________________________________________________________________

gmtime（取得目前时间和日期）

相关函数time,asctime,ctime,localtime

表头文件#include

定义函数structtm*gmtime（consttime_t*timep）;

函数说明gmtime（）将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果由结构tm返回。

结构tm的定义为

structtm{

inttm_sec;

inttm_min;

inttm_hour;

inttm_mday;

inttm_mon;

inttm_year;

inttm_wday;

inttm_yday;

inttm_isdst;

};

inttm_sec代表目前秒数，正常范围为0-59，但允许至61秒

inttm_min代表目前分数，范围0-59

inttm_hour从午夜算起的时数，范围为0-23

inttm_mday目前月份的日数，范围01-31

inttm_mon代表目前月份，从一月算起，范围从0-11

inttm_year从1900年算起至今的年数

inttm_wday一星期的日数，从星期一算起，范围为0-6

inttm_yday从今年1月1日算起至今的天数，范围为0-365

inttm_isdst日光节约时间的旗标

此函数返回的时间日期未经时区转换，而是UTC时间。

返回值返回结构tm代表目前UTC时间

范例#include

intmain（）{

char*wday[]={"Sun","Mon","Tue","Wed","Thu","Fri","Sat"};

time_ttimep;

structtm*p;

time（&timep）;

p=gmtime（&timep）;

printf（“%d%d%d”,（1900+p->tm_year）,（1+p->tm_mon）,p->tm_mday）;

printf（“%s%d;%d;%d\n”,wday[p->tm_wday],p->tm_hour,p->tm_min,p->tm_sec）;

return0;

}

执行

2000/10/28Sat8:

15:

##############################################################################

_______________________________________________________________________________

localtime（取得当地目前时间和日期）