第十一天学习-linux几种时间函数总结

linux几种时间函数总结

一、linux时间函数总结

最近的工作中用到的时间函数比较频繁，今天抽时间总结一下，在linux下，常用的获取时间的函数有如下几个：

asctime, ctime, gmtime, localtime, gettimeofday ，

mktime, asctime_r, ctime_r, gmtime_r, localtime_r

二、常用的结构体

（1）struct tm ；

struct tm {
               int tm_sec;         /* seconds */
               int tm_min;         /* minutes */
               int tm_hour;        /* hours */
               int tm_mday;        /* day of the month */
               int tm_mon;         /* month */
               int tm_year;        /* year */
               int tm_wday;        /* day of the week */
               int tm_yday;        /* day in the year */
               int tm_isdst;       /* daylight saving time */
           };
           
//int tm_sec 代表目前秒数，正常范围为0-59，但允许至61秒
//int tm_min 代表目前分数，范围0-59
//int tm_hour 从午夜算起的时数，范围为0-23
//int tm_mday 目前月份的日数，范围01-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 日光节约时间的旗标

（2）struct timeval，struct timezone；

struct timeval {
               time_t      tv_sec;     /* seconds (秒)*/
               suseconds_t tv_usec;    /* microseconds（微秒） */
           };
struct timezone {
               int tz_minuteswest;     /* minutes west of Greenwich */
               int tz_dsttime;         /* type of DST correction */
           };
int tz_minuteswest;     /* 格林威治时间往西方的时差 */
int tz_dsttime;         /*  时间的修正方式*/

三、时间函数介绍：

（1）time() 函数获取当前时间

SYNOPSIS
       #include <time.h>

       time_t time(time_t *t);

DESCRIPTION
       time() returns the time as the number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).
    //此函数会返回从公元1970年1月1日的UTC时间从0时0分0秒算起到现在所经过的秒数。如果t 并非空指针的话，此函数也会将返回值存到t指针所指的内存。
RETURN VALUE
       On  success,  the value of time in seconds since the Epoch is returned.  On error, ((time_t) -1) is returned, and errno is
       set appropriately.
ERRORS
       EFAULT t points outside your accessible address space.
    //成功返回秒数，错误则返回(time_t) -1)，错误原因存于errno中

eg:

#include <stdio.h>
#include <string.h>
#include <time.h>

int main()
{
    time_t seconds;

    seconds = time((time_t *)NULL);
    printf("%d\n", seconds);

    return 0;
}

（2）localtime_r() localtime()取得当地目前时间和日期
函数原型如下

#include <time.h>
       
    struct tm *localtime(const time_t *timep);
    struct tm *localtime_r(const time_t *timep, struct tm *result);
        
/*该函数将有time函数获取的值timep转换真实世界所使用的时间日期表示方法，然后将结果由结构tm返回*/

/**需要注意的是localtime函数可以将时间转换本地时间，但是localtime函数不是线程安全的。
多线程应用里面，应该用localtime_r函数替代localtime函数，因为localtime_r是线程安全的**/

eg：

#include <stdio.h>
#include <string.h>
#include <time.h>

int main()
{
    time_t timep;   
    struct tm *p; 
   
    time(&timep);   
    p = localtime(&timep);
   
    printf("%d-%d-%d %d:%d:%d\n", (1900 + p->tm_year), ( 1 + p->tm_mon), p->tm_mday,
                                (p->tm_hour + 12), p->tm_min, p->tm_sec); 

    return 0;
}

（3）asctime() asctime_r() 将时间和日期以字符串格式返回‘

函数原型如下：

#include <time.h>
       
    struct tm *gmtime(const time_t *timep);
    struct tm *gmtime_r(const time_t *timep, struct tm *result);
       
    char *asctime(const struct tm *tm);
    char *asctime_r(const struct tm *tm, char *buf);
       
       
/**gmtime是把日期和时间转换为格林威治(GMT)时间的函数。将参数time 所指的time_t 结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果由结构tm返回**/
       
/**asctime 将时间以换为字符串字符串格式返回 **/

eg：

#include <stdio.h>
#include <string.h>
#include <time.h> 
  
int main() 
{   
    time_t timep;   
    time(&timep);
   
    printf("%s\n", asctime(gmtime(&timep)));   
    
    return 0;
}

（4） ctime()，ctime_r() 将时间和日期以字符串格式表示

函数原型如下：

1 #include <time.h>
2        
3        char *ctime(const time_t *timep);
4        char *ctime_r(const time_t *timep, char *buf);
5        
6 /**ctime()将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回**/

eg：

#include <stdio.h>
#include <string.h>
#include <time.h>   

int main(void)   
{   
    time_t timep;
 
    time(&timep);   
    printf("%s\n", ctime(&timep));
    
    return 0;  
}

（5）mktime() 将时间结构体struct tm的值转化为经过的秒数
函数原型：

1 #include <time.h>
2        
3     time_t mktime(struct tm *tm);
4        
5 /**将时间结构体struct tm的值转化为经过的秒数**/

eg：

#include <stdio.h>
#include <string.h>
#include <time.h>  
 
int main()   
{   
    time_t timep;   
    struct tm *p;   

    time(&timep);   
    p = localtime(&timep);   
    timep = mktime(p);
   
    printf("%d\n", timep);   
    
    return 0;
}

最后结果可以看出mktime转化后的时间与time函数获取的一样

（6）gettimeofday() 获取当前时间
函数原型如下：

#include <sys/time.h>

    int gettimeofday(struct timeval *tv, struct timezone *tz);
    
	struct timeval
	 {
     	  time_t      tv_sec;     /* seconds (秒)*/
    	  suseconds_t tv_usec;    /* microseconds（微秒） */
     };
	struct timezone 
	{
         int tz_minuteswest;     /* minutes west of Greenwich */
         int tz_dsttime;         /* type of DST correction */
    };
//gettimeofday函数获取当前时间存于tv结构体中，相应的时区信息则存于tz结构体中
//需要注意的是tz是依赖于系统，不同的系统可能存在获取不到的可能，因此通常设置为NULL

eg：

#include <stdio.h>
#include <string.h>
#include <sys/time.h>

int main()
{
    struct timeval tv; 
    
    gettimeofday(&tv, NULL);

    printf("tv_sec: %d\n", tv.tv_sec);
    printf("tv_usec: %d\n", tv.tv_usec);
    
    return 0;
}