struct tm {

    int tm_sec;    /* Seconds (0-60) */

    int tm_min;    /* Minutes (0-59) */

    int tm_hour;   /* Hours (0-23) */

    int tm_mday;   /* Day of the month (1-31) */

    int tm_mon;    /* Month (0-11) */

    int tm_year;   /* Year - 1900 */

    int tm_wday;   /* Day of the week (0-6, Sunday = 0) */

    int tm_yday;   /* Day in the year (0-365, 1 Jan = 0) */

    int tm_isdst;  /* Daylight saving time */

};

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 */

};

/* time () 函数，返回一个从 1970 年 1 月 1 日 00:00:00 到现在的 time_t 类型 UTC 时间，当参数为 NULL 时直接返回秒数，当然也会将该值写入 t 指针指向的地址。 */

time_t time(time_t *t);

/* mktime () 会把本地时间转换为 UTC 时间 */

time_t mktime(struct tm *tm);

//note：两者区别在于传入的参数结构体不同，mktime 存在时区转换；time (t) 等价于 mktime (localtime (time (t)))。

/* gmtime () 是零时区，把 UTC 时间转换成北京时间的话，需要在年数上加 1900，月份上加 1，小时数加上 8。 */

struct tm *gmtime(const time_t *timep);

struct tm *gmtime_r(const time_t *timep, struct tm *result);

/* localtime () 将得到本地时间，该函数与 gmtime () 唯一区别是，在转换成北京时间的小时数不需要加上 8。 */

struct tm *localtime(const time_t *timep);

struct tm *localtime_r(const time_t *timep, struct tm *result);

//note：localtime 是将时区考虑在内了，转出的是当前时区的时间。但是注意，有些嵌入式设备上被裁减过的系统，时区没有被设置好，导致二者转出来的时间都是零时区的。在多线程应用里面，应该用后缀不带 `_r` 的函数，如： localtime_r 函数替代 localtime 函数，因为 localtime_r 是线程安全的，例子看第五大点。

/* 将 tm 结构中的时间信息转换为相应时间的字符串 */

char *asctime(const struct tm *tm);

char *asctime_r(const struct tm *tm, char *buf);

/* 将日历时间参数 timep 转换为一个表示本地当前时间的字符串，函数已经由时区转换成当地时间 */

char *ctime(const time_t *timep);

char *ctime_r(const time_t *timep, char *buf);

//note：两者区别在于传入的参数结构体不同，但转换出来的信息格式显示是一样的；asctime 是直接把时间格式化，而 ctime 是经过时区转换后再格式化输出；ctime (t) 等价于 asctime (localtime (t))。

/* 常用时间格式化参数看下方描述 */

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

double difftime(time_t time1, time_t time0);

#include <sys/time.h>

获取 struct timeval 类型的时间：

/* 相对于 time () 和 mktime () ，gettimeofday () 能获取更精准的微秒级别，及相应的时区信息，需要注意的是 tz 是依赖于系统，不同的系统可能存在获取不到的可能，因此通常设置为 NULL */

int gettimeofday(struct timeval *tv, struct timezone *tz);

// 成功则返回 0，失败返回 －1，错误代码存于 errno

// EFAULT：指针 tv 或 tz 所指的内存空间无效。

设置 struct timeval 类型的时间：

int settimeofday(const struct timeval *tv,const struct timezone *tz);

// 成功则返回 0，失败返回 －1，错误代码存于 errno

// EPERM：调用进程没有足够权限调用 settimeofday ()，即权限不够。

// EINVAL：时区或其它内容无效，无法正确设置时间。

//note：settimeofday 的修改时间需要在 root 权限下才能配置成功。

time_t get_localtime_interval(void)

{

    time_t timep_utc, timep_local;

    struct tm tm_utc;

    time(&timep_utc);

    gmtime_r(&timep_utc, &tm_utc);

	timep_local = mktime(&tm_utc);

	return (timep_utc - timep_local);

}

time_t get_time_stamp(void)

{

	time_t timep;

	time(&timep);

	timep += get_localtime_interval(timep);

	return timep;

}

time_t get_time_stamp(void)

{

	time_t timep_zone;

    timep_zone = get_localtime_interval(timep) / 3600;

	return timep_zone;

}

#include <stdio.h>  

#include <time.h>  

#include <stdlib.h>    

int main(int argc, const char * argv[])  

{  

    setenv("TZ", "CST-8", 1);   // 北京东八区

    //setenv ("TZ", "UTC+0", 1);   // 将当前时区设置成标准区

    char buf[64];

    struct timeval tv;

    struct tm* tm_time;

    gettimeofday(&tv, NULL);

    tm_time = gmtime(&tv.tv_sec);

    strftime(buf, sizeof(buf), "%a %b %m %H:%M:%S %Z %Y", tm_time);

    printf("GMT time: %s\n", buf);

    tm_time = localtime(&tv.tv_sec);

    strftime(buf, sizeof(buf), "%a %b %m %H:%M:%S %Z %Y", tm_time);

    printf("local time: %s\n", buf);

    return 0;

}

#include <stdio.h>

#include <stdlib.h>

#include <unistd.h>

#include <time.h>

int main()

{

    time_t curTime = time(NULL);

    time_t aftTime = curTime + 3600*3;

    struct tm *pTm1 = localtime(&curTime);

    struct tm *pTm2 = localtime(&aftTime);

    fprintf(stdout, "%04d%02d%02d%02d%02d%02d\n",

            pTm1->tm_year + 1900,

            pTm1->tm_mon + 1,

            pTm1->tm_mday,

            pTm1->tm_hour,

            pTm1->tm_min,

            pTm1->tm_sec);

    fprintf(stdout, "%04d%02d%02d%02d%02d%02d\n",

            pTm2->tm_year + 1900,

            pTm2->tm_mon + 1,

            pTm2->tm_mday,

            pTm2->tm_hour,

            pTm2->tm_min,

            pTm2->tm_sec);

    return 0;

}

#include <stdio.h>

#include <stdlib.h>

#include <unistd.h>

#include <time.h>

int main()

{

    time_t curTime = time(NULL);

    time_t aftTime = curTime + 3600*3;

    struct tm tm1;

    struct tm tm2;

    localtime_r(&curTime, &tm1);

    localtime_r(&aftTime, &tm2);

    fprintf(stdout, "%04d%02d%02d%02d%02d%02d\n",

            tm1.tm_year + 1900,

            tm1.tm_mon + 1,

            tm1.tm_mday,

            tm1.tm_hour,

            tm1.tm_min,

            tm1.tm_sec);

    fprintf(stdout, "%04d%02d%02d%02d%02d%02d\n",

            tm2.tm_year + 1900,

            tm2.tm_mon + 1,

            tm2.tm_mday,

            tm2.tm_hour,

            tm2.tm_min,

            tm2.tm_sec);

    return 0;

}