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 时区名称，如果不能得到时区名称则返回空字符。
%% 百分号

如果想显示现在是几点了，并以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