时间相关函数

linux时间函数有不少，平时用的也比较多，但是这些函数经常忘了，故记录下来，留作以后编程查询之用。

time函数

#include 
time_t time(time_t * t)

此函数会返回从公元1970年1月1日的UTC时间从0时0分0秒算起到现在所经过的秒数。如果t 并非空指针的话，此函数也会将返回值存到t指针所指的内存.发生错误返回-1.

clock_gettime

#include 
int clock_gettime(clockid_t clock_t,struct timespec * tsp);

此函数用于获取指定的时钟时间.常用如下4种时钟：
CLOCK_REALTIME 统当前时间，从1970年1.1日算起
CLOCK_MONOTONIC 系统的启动时间，不能被设置
CLOCK_PROCESS_CPUTIME_ID 本进程运行时间
CLOCK_THREAD_CPUTIME_ID 本线程运行时间.
成功返回0，发生错误返回-1。

struct timespec 的结构如下：

struct timespec {
  time_t tv_sec; // seconds
  long tv_nsec; // and nanoseconds
};

当clockid_t为CLOCK_REALTIME时，clock_gettime函数跟time函数功能类似。

gettimeofday函数

#include 

int gettimeofday (struct timeval * tp, void * tzp);

gettimeofday 返回成功时函数将距离1970.1.1 的时间存储在指针tp指向的地址中，struct timeval 的结构如下。tzp 依赖于相关unix平台实现来代表时区。返回值总是返回0.

struct timeval {
  time_t tv_sec; // seconds
  long tv_usec; // microseconds
};

localtime和gmtime

#include 

struct tm * gmtime(const time_t * calptr);

struct tm * localtime(const time_t * calptr);

gmtime和localtime 两个函数将日历时间转换为分解时间，并将其存在struct tm 结构中.

struct tm {
int tm_sec;    /* 秒 – 取值区间为[0,59] */
int tm_min;    /* 分 - 取值区间为[0,59] */
int tm_hour;   /* 时 - 取值区间为[0,23] */
int tm_mday;   /* 一个月中的日期 - 取值区间为[1,31] */
int tm_mon;    /* 月份（从一月开始，0代表一月） - 取值区间为[0,11] */
int tm_year;   /* 年份，其值等于实际年份减去1900 */
int tm_wday;   /* 星期 – 取值区间为[0,6]，其中0代表星期天，1代表星期一，以此类推 */
int tm_yday;   /* 从每年的1月1日开始的天数 – 取值区间为[0,365]，其中0代表1月1日，1代表1月2日，以此类推 */
int tm_isdst;   /* 夏令时标识符，实行夏令时的时候，tm_isdst为正。不实行夏令时的时候，tm_isdst为0；  不了解情况时，tm_isdst()为负*/。
long int tm_gmtoff;  /*指定了日期变更线东面时区中UTC东部时区正秒数或UTC西部时区的负秒数*/
const char *tm_zone;   /*当前时区的名字(与环境变量TZ有关)*/
};

localtime将日历时间转换成本地时区时间，gmtime则将日历时间转换成协调统一的时间结构。

mktime

函数mktime以struct tm * 为参数，将tm结构代表的时间转换为time_t

#include 

time_t mktime(struct tm * tmptr)