| asctime（將時(shí)間和日期以字符串格式表示） |
| 相關(guān)函數(shù) | time，ctime，gmtime，localtime
|
| 表頭文件 | #include<time.h>
|
| 定義函數(shù) | char * asctime(const struct tm * timeptr);
|
| 函數(shù)說(shuō)明 | asctime()將參數(shù)timeptr所指的tm結(jié)構(gòu)中的信息轉(zhuǎn)換成真實(shí)世界所使用的時(shí)間日期表示方法，然后將結(jié)果以字符串形態(tài)返回。此函數(shù)已經(jīng)由時(shí)區(qū)轉(zhuǎn)換成當(dāng)?shù)貢r(shí)間，字符串格式為:“Wed Jun 30 21:49:08 1993\n”
|
| 返回值 | 若再調(diào)用相關(guān)的時(shí)間日期函數(shù)，此字符串可能會(huì)被破壞。此函數(shù)與ctime不同處在于傳入的參數(shù)是不同的結(jié)構(gòu)。
|
| 附加說(shuō)明 | 返回一字符串表示目前當(dāng)?shù)氐臅r(shí)間日期。
|
| 范例 | #include <time.h>
main()
{
time_t timep;
time (&timep);
printf(“%s”,asctime(gmtime(&timep)));
}
|
| 執(zhí)行 | Sat Oct 28 02:10:06 2000
|
| |
|
|
ctime（將時(shí)間和日期以字符串格式表示） |
| 相關(guān)函數(shù) | time，asctime，gmtime，localtime
|
| 表頭文件 | #include<time.h>
|
| 定義函數(shù) | char *ctime(const time_t *timep);
|
| 函數(shù)說(shuō)明 | ctime()將參數(shù)timep所指的time_t結(jié)構(gòu)中的信息轉(zhuǎn)換成真實(shí)世界所使用的時(shí)間日期表示方法，然后將結(jié)果以字符串形態(tài)返回。此函數(shù)已經(jīng)由時(shí)區(qū)轉(zhuǎn)換成當(dāng)?shù)貢r(shí)間，字符串格式為“Wed Jun 30 21 :49 :08 1993\n”。若再調(diào)用相關(guān)的時(shí)間日期函數(shù)，此字符串可能會(huì)被破壞。
|
| 返回值 | 返回一字符串表示目前當(dāng)?shù)氐臅r(shí)間日期。
|
| 范例 | #include<time.h>
main()
{
time_t timep;
time (&timep);
printf(“%s”,ctime(&timep));
}
|
| 執(zhí)行 | Sat Oct 28 10 : 12 : 05 2000
|
| |
|
|
gettimeofday（取得目前的時(shí)間） |
| 相關(guān)函數(shù) | time，ctime，ftime，settimeofday
|
| 表頭文件 | #include <sys/time.h>
#include <unistd.h>
|
| 定義函數(shù) | int gettimeofday ( struct timeval * tv , struct timezone * tz )
|
| 函數(shù)說(shuō)明 | gettimeofday()會(huì)把目前的時(shí)間有tv所指的結(jié)構(gòu)返回，當(dāng)?shù)貢r(shí)區(qū)的信息則放到tz所指的結(jié)構(gòu)中。
timeval結(jié)構(gòu)定義為:
struct timeval{
long tv_sec; /*秒*/
long tv_usec; /*微秒*/
};
timezone 結(jié)構(gòu)定義為:
struct timezone{
int tz_minuteswest; /*和Greenwich 時(shí)間差了多少分鐘*/
int tz_dsttime; /*日光節(jié)約時(shí)間的狀態(tài)*/
};
上述兩個(gè)結(jié)構(gòu)都定義在/usr/include/sys/time.h。tz_dsttime 所代表的狀態(tài)如下
DST_NONE /*不使用*/
DST_USA /*美國(guó)*/
DST_AUST /*澳洲*/
DST_WET /*西歐*/
DST_MET /*中歐*/
DST_EET /*東歐*/
DST_CAN /*加拿大*/
DST_GB /*大不列顛*/
DST_RUM /*羅馬尼亞*/
DST_TUR /*土耳其*/
DST_AUSTALT /*澳洲（1986年以后）*/
|
| 返回值 | 成功則返回0，失敗返回－1，錯(cuò)誤代碼存于errno。附加說(shuō)明EFAULT指針tv和tz所指的內(nèi)存空間超出存取權(quán)限。
|
| 范例 | #include<sys/time.h>
#include<unistd.h>
main(){
struct timeval tv;
struct timezone tz;
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);
}
|
| 執(zhí)行 | tv_sec: 974857339
tv_usec:136996
tz_minuteswest:-540
tz_dsttime:0
|
| |
|
|
gmtime（取得目前時(shí)間和日期） |
| 相關(guān)函數(shù) | time,asctime,ctime,localtime
|
| 表頭文件 | #include<time.h>
|
| 定義函數(shù) | struct tm*gmtime(const time_t*timep);
|
| 函數(shù)說(shuō)明 | gmtime()將參數(shù)timep 所指的time_t 結(jié)構(gòu)中的信息轉(zhuǎn)換成真實(shí)世界所使用的時(shí)間日期表示方法，然后將結(jié)果由結(jié)構(gòu)tm返回。
結(jié)構(gòu)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;
};
int tm_sec 代表目前秒數(shù)，正常范圍為0-59，但允許至61秒
int tm_min 代表目前分?jǐn)?shù)，范圍0-59
int tm_hour 從午夜算起的時(shí)數(shù)，范圍為0-23
int tm_mday 目前月份的日數(shù)，范圍01-31
int tm_mon 代表目前月份，從一月算起，范圍從0-11
int tm_year 從1900 年算起至今的年數(shù)
int tm_wday 一星期的日數(shù)，從星期一算起，范圍為0-6
int tm_yday 從今年1月1日算起至今的天數(shù)，范圍為0-365
int tm_isdst 日光節(jié)約時(shí)間的旗標(biāo)
此函數(shù)返回的時(shí)間日期未經(jīng)時(shí)區(qū)轉(zhuǎn)換，而是UTC時(shí)間。
|
| 返回值 | 返回結(jié)構(gòu)tm代表目前UTC 時(shí)間
|
| 范例 | #include <time.h>
main(){
char *wday[]={"Sun","Mon","Tue","Wed","Thu","Fri","Sat"};
time_t timep;
struct tm *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);
}
|
| 執(zhí)行 | 2000/10/28 Sat 8:15:38
|
| |
|
|
localtime（取得當(dāng)?shù)啬壳皶r(shí)間和日期） |
| 相關(guān)函數(shù) | time, asctime, ctime, gmtime
|
| 表頭文件 | #include<time.h>
|
| 定義函數(shù) | struct tm *localtime(const time_t * timep);
|
| 函數(shù)說(shuō)明 | localtime()將參數(shù)timep所指的time_t結(jié)構(gòu)中的信息轉(zhuǎn)換成真實(shí)世界所使用的時(shí)間日期表示方法，然后將結(jié)果由結(jié)構(gòu)tm返回。結(jié)構(gòu)tm的定義請(qǐng)參考gmtime()。此函數(shù)返回的時(shí)間日期已經(jīng)轉(zhuǎn)換成當(dāng)?shù)貢r(shí)區(qū)。
|
| 返回值 | 返回結(jié)構(gòu)tm代表目前的當(dāng)?shù)貢r(shí)間。
|
| 范例 | #include<time.h>
main(){
char *wday[]={“Sun”,”Mon”,”Tue”,”Wed”,”Thu”,”Fri”,”Sat”};
time_t timep;
struct tm *p;
time(&timep);
p=localtime(&timep); /*取得當(dāng)?shù)貢r(shí)間*/
printf (“%d%d%d ”, (1900+p->tm_year),( l+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);
}
|
| 執(zhí)行 | 2000/10/28 Sat 11:12:22
|
| |
|
|
mktime（將時(shí)間結(jié)構(gòu)數(shù)據(jù)轉(zhuǎn)換成經(jīng)過(guò)的秒數(shù)） |
| 相關(guān)函數(shù) | time，asctime，gmtime，localtime
|
| 表頭文件 | #include<time.h>
|
| 定義函數(shù) | time_t mktime(strcut tm * timeptr);
|
| 函數(shù)說(shuō)明 | mktime()用來(lái)將參數(shù)timeptr所指的tm結(jié)構(gòu)數(shù)據(jù)轉(zhuǎn)換成從公元1970年1月1日0時(shí)0分0 秒算起至今的UTC時(shí)間所經(jīng)過(guò)的秒數(shù)。
|
| 返回值 | 返回經(jīng)過(guò)的秒數(shù)。
|
| 范例 | /* 用time()取得時(shí)間（秒數(shù)），利用localtime()
轉(zhuǎn)換成struct tm 再利用mktine（）將struct tm轉(zhuǎn)換成原來(lái)的秒數(shù)*/
#include<time.h>
main()
{
time_t timep;
strcut tm *p;
time(&timep);
printf(“time() : %d \n”,timep);
p=localtime(&timep);
timep = mktime(p);
printf(“time()->localtime()->mktime():%d\n”,timep);
}
|
| 執(zhí)行 | time():974943297
time()->localtime()->mktime():974943297
|
| |
|
|
settimeofday（設(shè)置目前時(shí)間） |
| 相關(guān)函數(shù) | time，ctime，ftime，gettimeofday
|
| 表頭文件 | #include<sys/time.h>
#include<unistd.h>
|
| 定義函數(shù) | int settimeofday ( const struct timeval *tv,const struct timezone *tz);
|
| 函數(shù)說(shuō)明 | settimeofday()會(huì)把目前時(shí)間設(shè)成由tv所指的結(jié)構(gòu)信息，當(dāng)?shù)貢r(shí)區(qū)信息則設(shè)成tz所指的結(jié)構(gòu)。詳細(xì)的說(shuō)明請(qǐng)參考gettimeofday()。注意，只有root權(quán)限才能使用此函數(shù)修改時(shí)間。
|
| 返回值 | 成功則返回0，失敗返回－1，錯(cuò)誤代碼存于errno。
|
| 錯(cuò)誤代碼 | EPERM 并非由root權(quán)限調(diào)用settimeofday（），權(quán)限不夠。
EINVAL 時(shí)區(qū)或某個(gè)數(shù)據(jù)是不正確的，無(wú)法正確設(shè)置時(shí)間。
|
| |
|
|
time（取得目前的時(shí)間） |
| 相關(guān)函數(shù) | ctime，ftime，gettimeofday
|
| 表頭文件 | #include<time.h>
|
| 定義函數(shù) | time_t time(time_t *t);
|
| 函數(shù)說(shuō)明 | 此函數(shù)會(huì)返回從公元1970年1月1日的UTC時(shí)間從0時(shí)0分0秒算起到現(xiàn)在所經(jīng)過(guò)的秒數(shù)。如果t 并非空指針的話(huà)，此函數(shù)也會(huì)將返回值存到t指針?biāo)傅膬?nèi)存。
|
| 返回值 | 成功則返回秒數(shù)，失敗則返回((time_t)-1)值，錯(cuò)誤原因存于errno中。
|
| 范例 | #include<time.h>
mian()
{
int seconds= time((time_t*)NULL);
printf(“%d\n”,seconds);
}
|
