C語言時間函數整理

C語言時間函數整理

用到的資料結構：
time_t是一個long類型 代表機器時間，可由time( )函數獲得。

日曆時間用一個(char *) 類型的字串表示。格式為：星期 月 日 小時：分：秒 年\n\0
可由函數ctime( ) asctime( ) 得到。

以tm結構表達的時間，結構tm定義如下：
struct tm { 可由函數localtime( ), gmtime( )得到
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; };
//系統日期
struct date {
int da_year; /* Year - 1980 */
char da_day; /* Day of the month */
char da_mon; /* Month (1 = Jan) */ };
//系統時間
struct time {
unsigned char ti_min; /* Minutes */
unsigned char ti_hour; /* Hours */
unsigned char ti_hund; /* Hundredths of seconds */
unsigned char ti_sec; /* Seconds */ };

用到的函數：
char *asctime(struct tm * ptr) 將tm結構的時間轉化為日曆時間。
char *ctime(long time) 將機器時間轉化為日曆時間。
struct tm *gmtime(time_t *time) 將機器時間轉化為tm時間

當ptr為空白時，得到機器時間；非空時，設定機器時間。
time_t time(time_t *ptr) 得到或設定機器時間
double difftime(time_t time2, time_t time1) 得到兩次機器時間差，單位為秒

long dostounix(struct data *d, struct time *t) 將DOS的日期和時間格式轉換成UNIX標準
（機器時間（用到dos.h庫）.void unixtodos(long utime, struct date *d, struct time *t)
將UNIX格式的時間和日期轉換成DOS格式（由time 和date兩部分組成，只能由機器時間得到，並且用到dos.h庫）
void getdate(struct date *d) 得到系統日期，d 存放得到的日期資訊
void setdate(struct date *d)
void gettime(struct date *t) 得到系統時間 d 存放得到的時間資訊
void settime(struct date *t)

C語言的標準庫函數包括一系列日期和時間處理函數，它們都在標頭檔中說明。下面列出了這些函數。
在標頭檔中定義了三種類型：time_t，struct tm和clock_t。

在中說明的C語言時間函數

time_t time(time_t *timer);

double difftime(time_t time1,time_t time2);

struct tm *gmtime(const time_t *timer);

struct tm *localtime(const time_t *timer);

char *asctime(const struct tm *timeptr);

char *ctime(const time_t *timer);

size_t strftime(char *s,size_t maxsize,const char *format,const struct tm *timeptr);

time_t mktime(struct tm *timeptr);

clock_t clock(void);

標頭檔time.h 

@函數名稱:     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()函數獲得的機器時間 

#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; 
}

我們可以使用strftime（）函數將時間格式化為我們想要的格式。它的原型如下：

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 時區名稱，如果不能得到時區名稱則返回Null 字元。
%% 百分比符號

如果想顯示現在是幾點了，並以12小時制顯示，就象下面這段程式：

#i nclude <time.h>
#i nclude <stdio.h>
int main(void)
{
struct tm *ptr;
time_t lt;
char str[80];
lt=time(NULL);
ptr=localtime(It);
strftime(str,100,"It is now %I %p",ptr);
printf(str);
return 0;
}

其運行結果為：
It is now 4PM