C语言时间函数(2)之time，ctime，gmtime，localtime，asctime，mktime

 一、时间相关说明

格林威治时间表示0时区的标准时间。其他时区的时间和此标准时间均有时间差。UTC（Universal Time Coordinated）是世界协调时间，是格林威治时间在互联网中的表示方法

二、标准C语言时间函数

1、time（取得本地目前的时间秒数）

#include

time_t time(time_t *t);

函数说明  此函数会返回从公元1970年1月1日的UTC时间从0时0分0秒（Epoch，linux纪元）算起到现在所经过的秒数。如果t 并非空指针的话，此函数也会将返回值存到t指针所指的内存。

返回值  成功则返回秒数，失败则返回((time_t)-1)值，错误原因存于errno中。

time_t 定义为long int

例子：

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

int main(void)
{
    time_t time1 = 0;
    long int time2 = 0;

    //time()函数传入的参数时NULL，函数返回值是1970年到现在经过的秒数
    time1 = time(NULL);
    printf("time1=%ld\n",time1);

    //time()函数传入的参数时time2的地址，返回1970年到现在经过的秒数给time2的内存
    time(&time2);
    printf("time2=%ld\n",time2);

    return 0;
}

执行的结果为：

time1=1514297416

time2=1514297416

2.ctime（将时间和日期以字符串格式表示） 

#include

char *ctime(const time_t *timep);

函数说明  ctime()将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回。此函数已经由时区转换成当地时间，字符串格式为“Wed Jun 30 21 :49 :08 1993\n”。若再调用相关的时间日期函数，此字符串可能会被破坏。

返回值  返回一字符串表示目前当地的时间日期。

例子：

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

int main(void)
{
    time_t timeValue = 0;
    char *str = NULL;

    timeValue = time(NULL);
    str = ctime(&timeValue);
    printf("时间字符串 = %s\n",str);

    return 0;
}

结果：

时间字符串 = Tue Dec 26 22:22:53 2017

在介绍其他时间函数之前先要了解一个C语言已经定义的结构体struct tm

struct tm

{

int tm_sec;

int tm_min;

int tm_hour;

int tm_mday;

int tm_mon;

int tm_year;

int tm_wday;

int tm_yday;

int tm_isdst;

};

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 日光节约时间的旗标

3.gmtime（根据本地时间取得目前的UTC时间）

#include

struct tm*gmtime(const time_t*timep);

函数说明  gmtime()将参数timep 所指的time_t 结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果由结构tm返回。

此函数返回的时间日期未经时区转换，而是UTC时间（格林尼治时间，北京时间晚8个小时，所以）。

返回值  返回结构tm代表目前UTC 时间

例子：

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

int main(void)
{
    time_t timeValue = 0;
    struct tm *p = NULL;

    time(&timeValue);
    p = gmtime(&timeValue);
    printf("现在的时间(UTC)是 = %d年%d月%d日 星期%d %d时%d分%d秒 \n",
           p->tm_year+1900,
           p->tm_mon+1,
           p->tm_mday,
           p->tm_wday,
           p->tm_hour,
           p->tm_min,
           p->tm_sec);

    return 0;
}

输出的结果：

现在的时间(UTC)是 = 2017年12月26日 星期2 14时47分21秒

现在本地时间是：

所以与北京时间相差8个小时

4.localtime（取得当地目前UTC时间和日期） 

#include

struct tm *localtime(const time_t * timep);

函数说明  localtime()将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果由结构tm返回。结构tm的定义请参考gmtime()。此函数返回的时间日期已经转换成当地时区。

返回值  返回结构tm代表目前的当地时间。

再次说明：这个函数返回的时期已经转换成本地时间。

例子：

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

int main(void)
{
    time_t timeValue = 0;
    struct tm *p = NULL;

    time(&timeValue);
    p = localtime(&timeValue);
    printf("现在的时间(已转为本地时间)是 = %d年%d月%d日 星期%d %d时%d分%d秒 \n",
           p->tm_year+1900,
           p->tm_mon+1,
           p->tm_mday,
           p->tm_wday,
           p->tm_hour,
           p->tm_min,
           p->tm_sec);

    return 0;
}

结果：现在的时间(已转为本地时间)是 = 2017年12月26日 星期2 22时59分19秒

5.

asctime（将时间和日期以字符串格式表示） 

#include

char * asctime(const struct tm * timeptr);

函数说明  asctime()将参数timeptr所指的tm结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回。此函数已经由时区转换成当地时间，字符串格式为:“Wed Jun 30 21:49:08 1993\n”

返回值  若再调用相关的时间日期函数，此字符串可能会被破坏。此函数与ctime不同处在于传入的参数是不同的结构。

附加说明  返回一字符串表示目前当地的时间日期。

对比分析：asctime()和ctimed都是将时间转换为日期的字符串，ctime()转换的是时间的秒数，asctime()转换的是tm结构体中的时间

例子：

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

int main(void)
{
    time_t timeValue = 0;
    struct tm *p = NULL;
    char *str = NULL;

    time(&timeValue);
    p = localtime(&timeValue);
    str = asctime(p);
    printf("现在的时间字符串是 = %s\n",str);

    return 0;
}

结果：现在的时间字符串是 = Tue Dec 26 23:04:58 2017

6.

mktime（将时间结构数据转换成经过的秒数） 

#include

time_t mktime(strcut tm * timeptr);

函数说明  mktime()用来将参数timeptr所指的tm结构数据转换成从公元1970年1月1日0时0分0 秒算起至今的UTC时间所经过的秒数。

返回值  返回经过的秒数。

范例  /* 用time()取得时间（秒数），利用localtime()

转换成struct tm 再利用mktine（）将struct tm转换成原来的秒数*/

例子：

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

int main(void)
{
    time_t timeValue = 0;
    struct tm *p = NULL;

    time(&timeValue);
    printf("转换之前的时间秒数是 = %ld\n",timeValue);
    p = localtime(&timeValue);

    timeValue = 0;
    timeValue = mktime(p);
    printf("转换之后的时间秒数是 = %ld\n",timeValue);

    return 0;
}

结果：

转换之前的时间秒数是 = 1514300922

转换之后的时间秒数是 = 1514300922