Linux常用的时间操作函数

一、头文件

    #include <time.h>

二、常见的函数

    常用的获取时间的函数有如下几个：  time(),asctime(), ctime(), gmtime(), localtime(), gettimeofday(),mktime(), asctime_r(), ctime_r(), gmtime_r(), localtime_r()； 

三、常用的结构体

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 */
};            
 /*tm_sec 代表目前秒数，正常范围为0-59，但允许至61秒*/
 /*tm_min 代表目前分数，范围0-59*/
 /*tm_hour 从午夜算起的时数，范围为0-23*/
 /*tm_mday 目前月份的日数，范围01-31*/
 /*tm_mon 代表目前月份，从一月算起，范围从0-11*/
 /*tm_year 从1900 年算起至今的年数*/
 /*tm_wday 一星期的日数，从星期一算起，范围为0-6*/
 /*tm_yday 从今年1月1日算起至今的天数，范围为0-365*/
 /*tm_isdst 日光节约时间的旗标*/

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 */             
};  
/* tz_minuteswest; 格林威治时间往西方的时差 */ 
/*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中  （time_t => long）

函数使用用例

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

int main(void)
{
    time_t seconds;

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

    return 0;
}

2、localtime()、localtime_r()取得当地目前时间和日期

#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是线程安全的*/

函数使用用例

#include <stdio.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 将时间以换为字符串字符串格式返回*/

函数使用用例

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

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

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

函数使用用例

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

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

5、mktime()将时间结构体"struct tm"的值转化为经过的秒数

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

函数使用用例

#include <stdio.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*/

函数使用用例

#include <stdio.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;
}