时间结构体/函数-linux
1、Linux 下常用时间类型

Linux下常用时间类型有四种：time_t、struct tm、struct timeval、struct timespec

1.1 time_t 时间类型

头文件：time.h：

[cpp] view plaincopyprint?

1. #ifndef __TIME_T
2. #define __TIME_T
3. typedef long time_t;
4. #endif

可见，time_t实际是一个长整型。其值表示为从UTC(coordinated universal time)时间从1970年1月1日00时00分00秒(也称为Linux系统的Epoch时间)到当前时刻的秒数。

由于time_t类型长度的限制，它所表示的时间不能晚于2038年1月19日03时14分07秒(UTC)。为了能够表示更久远的时间，可用64位或更长的整形数来保存日历时间，这里不作详述。

使用time()函数获取当前时间的time_t值，使用ctime()函数将time_t转为当地时间字符串。

备注：

UTC时间有时也称为GMT时间，其实UTC和GMT两者几乎是同一概念。它们都是指格林尼治标准时间，只不过UTC的称呼更为正式一点。两者区别在于前者是天文上的概念，而后者是基于一个原子钟。

1.2 struct tm 时间类型

头文件：time.h：

[cpp] view plaincopyprint?

1. #ifndef _TM_DEFINED
2. struct tm
3. {
4. int tm_sec; /*秒 - 取值区间为[0, 59]*/
5. int tm_min; /*分 - 取值区间为[0, 59]*/
6. int tm_hour; /*时 - 取值区间为[0, 23]*/
7. int tm_mday; /*日 - 取值区间为[1, 31]*/
8. int tm_mon; /*月份 - 取值区间为[0, 11]*/
9. int tm_year; /*年份 - 其值为1900年至今年数*/
10. int tm_wday; /*星期 - 取值区间[0, 6]，0代表星期天，1代表星期1，以此类推*/
11. int tm_yday; /*从每年的1月1日开始的天数-取值区间为[0, 365]，0代表1月1日*/
12. int tm_isdst; /*夏令时标识符，使用夏令时，tm_isdst为正，不使用夏令时，tm_isdst为0，不了解情况时，tm_isdst为负*/
13. };
14. #define _TM_DEFINED
15. #endif

ANSI C标准称使用tm结构的这种时间表示为分解时间(broken-down time)。
使用 gmtime() 和 localtime() 可将 time_t 时间类型转换为 struct tm 结构体；
使用 mktime() 将 struct tm 结构体转换为 time_t 时间类型；
使用 asctime() 将 struct tm 转换为 字符串 形式。

1.3 struct timeval 时间类型

头文件：time.h：

[cpp] view plaincopyprint?

1. Struct tmieval{
2. time_t tv_sec; /*秒s*/
3. suseconds_t tv_usec; /*微秒us*/
4. };

设置时间函数 settimeofday( )与获取时间函数 gettimeofday( ) 均使用该事件类型作为传参。

1.4 struct timespec 时间类型

头文件：time.h：

[cpp] view plaincopyprint?

1. struct timespec{
2. time_t tv_sec; /*秒s*/
3. long tv_nsec; /*纳秒ns*/
4. };

2、Linux下常用时间函数

有：time( )、ctime( )、gmtime( )、localtime( )、mktime( )、asctime( )、difftime( )、gettimeofday( )、settimeofday( )

2.1 time( )函数
头文件：#include <time.h>
函数定义：time_t time(time_t *timer)
功能描述：该函数返回从1970年1月1日00时00分00秒至今所经过的秒数。如果time_t *timer非空指针，函数也会将返回值存到timer指针指向的内存。
返回值：成功则返回秒数，失败则返回((time_t)-1)值，错误原因存于errno中。
例：
[cpp] view plaincopyprint?

1. time_t seconds;
2. seconds = time((time_t *)NULL);

2.2 ctime( )函数
头文件：#include <time.h>
函数定义：char *ctime(const time_t *timep);
功能描述：ctime( )将参数timep指向的time_t时间信息转换成实际所使用的时间日期表示方法，并以字符串形式返回。字符串格式为："Wed Jun 20 21:00:00 2012\n"。
例：
[cpp] view plaincopyprint?

1. time_t timep;
2. tmep = time(NULL);
3. printf("%s\n", ctime(&timep));

结果：

Wed Jun 20 21:00:00 2012

2.3 gmtime( ) 函数
头文件：#include <time.h>
函数定义：struct tm *gmtime(const time_t *timep)
功能描述：gmtime( )将参数timep指向的 time_t 时间信息转换成以 struct tm 结构体表示的GMT时间信息，并以struct tm*指针返回。
GMT：GMT是中央时区,北京在东8区,相差8个小时，所以北京时间=GMT时间+8小时。
例：
[cpp] view plaincopyprint?

1. int main(void)
2. {
3. char *wday[] = {"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"};
4. time_t timep;
5. struct tm *p_tm;
6. timep = time(NULL);
7. p_tm = gmtime(&timep); /*获取GMT时间*/
8. printf("%d-%d-%d ", (p_tm->tm_year+1900), (p_tm->mon+1), p_tm->tm_mday);
9. printf("%s %d:%d:%d\n", wday[p_tm->tm_wday], p_tm->tm_hour, p_tm->tm_min, p_tm->tm_sec);
10. }

2.4 localtime( )函数
头文件：#include <time.h>
函数定义：struct tm *localtime(const time_t *timep);
功能描述：localtime( )将参数timep指向的time_t时间信息转换成以tm结构体表示的本地时区时间(如北京时间= GMT+小时)。
例：
[cpp] view plaincopyprint?

1. int main(void)
2. {
3. char *wday[] = {"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"};
4. time_t timep;
5. struct tm *p_tm;
6. timep = time(NULL);
7. p_tm = localtime(&timep); /*获取本地时区时间*/
8. printf("%d-%d-%d ", (p_tm->tm_year+1900), (p_tm->mon+1), p_tm->tm_mday);
9. printf("%s %d:%d:%d\n", wday[p_tm->tm_wday], p_tm->tm_hour, p_tm->tm_min, p_tm->tm_sec);
10. return 0;
11. }

[cpp] view plaincopyprint?
int main(void)  
{  
    time_t timep:  
    struct tm *p_tm;  
    timep = time(NULL);  
    pintf("time( ):%d\n", timep);  
    p_tm = local(&timep);  
    timep = mktime(p_tm);  
    printf("time( )->localtime( )->mktime( ):%d\n", timep);  
    return 0;  
}  

2.6 asctime( )函数
头文件：#include <time.h>
函数定义：char *asctime(const struct tm *p_tm);
功能描述：asctime( )将参数p_tm指向的 struct tm 结构体数据转换成实际使用的时间日期表示方法，并以字符串形式返回(与ctime函数相同)。字符串格式为："Wed Jun 20 21:00:00 2012\n"。
例：
[cpp] view plaincopyprint?
int main(void)  
{  
    time_t timep;  
    timep = time(NULL);  
    printf("%s\n", asctime(gmtime(&timep)));  
    return 0;  
}  
结果：
Wed Jun 20 21:00:00 2012

2.7 difftime( )函数
头文件：#include <time.h>
函数定义：double difftime(time_t timep1, time_t timep2);
功能描述：difftime( )比较参数timep1和timep2时间是否相同，并返回之间相差秒数。
例：
[cpp] view plaincopyprint?
int main(void)  
{  
    time_t timep1, timep2;  
    timep1 = time(NULL);  
    sleep(2);  
    timep2 = time(NULL);  
    printf("the difference is %f seconds\n", difftime(timep1, timep2));  
    return 0;  
}  

2.8 gettimeofday( )函数
头文件：#include <sys/time.h>
        #include <unistd.h>
函数定义：int gettimeofday(struct timeval *tv, struct timezone *tz);
功能描述：gettimeofday( )把目前的时间信息存入tv指向的结构体，当地时区信息则放到tz指向的结构体。
struct timezone原型：
[cpp] view plaincopyprint?
struct timezone{  
    int tz_minuteswest; /*miniutes west of Greenwich*/  
    int tz_dsttime; /*type of DST correction*/  
};  
例：
[cpp] view plaincopyprint?
struct timeval tv;  
struct timeval tz;  
gettimeofday(&tv, &tz);  
附：
使用time函数族获取时间并输出指定格式字符串例子（strftime( )函数）：
[cpp] view plaincopyprint?
int main(void)  
{  
    char strtime[20] = {0};  
    time_t timep;  
    struct tm *p_tm;  
    timep = time(NULL);  
    p_tm = localtime(&timep);  
    strftime(strtime, sizeof(strtime), "%Y-%m-%d %H:%M:%S", p_tm);  
    return 0;  
}  

2.9 settimeofday( )函数
头文件：#include <sys/time.h>
        #include <unistd.h>
函数定义：int settimeofday(const struct timeval *tv, const struct timezone *gz);
功能描述：settimeofday( )把当前时间设成由tv指向的结构体数据。当前地区信息则设成tz指向的结构体数据。
例：
[cpp] view plaincopyprint?
int main(void)  
{  
    char t_string[] = "2012-04-28 22:30:00";  
    struct tm time_tm;  
    struct timeval time_tv;  
    time_t timep;  
    int ret = 0;  
  
    sscanf(t_string, "%d-%d-%d %d:%d:%d", &time_tm.tm_year, &time_tm.tm_mon, &time_tm.tm_mday, &time_tm.tm_hour, &time_tm.tm_min, &time_tm.tm_sec);  
    time_tm.tm_year -= 1900;  
    time_tm.tm_mon -= 1;  
    time_tm.tm_wday = 0;  
    time_tm.tm_yday = 0;  
    time_tm.tm_isdst = 0;  
  
    timep = mktime(&time_tm);  
    time_tv.tv_sec = timep;  
    time_tv.tv_usec = 0;  
  
    ret = settimeofday(&time_tv, NULL);  
    if(ret != 0)  
    {  
        fprintf(stderr, "settimeofday failed\n");  
        return -1;  
    }  
    return 0;  
}