函数

一、asctime()
二、ctime()
三、gettimeofday()
四、gmtime()
五、localtime()
六、mktime()
七、time()

一、asctime()

• 描述
  C 库函数 char *asctime(const struct tm *timeptr) 返回一个指向字符串的指针，它代表了结构 struct timeptr 的日期和时间。功能就是将时间日期以字符串格式表示

• 声明

char *asctime(const struct tm *timeptr)

-参数
timeptr 是指向 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 到 11                */
   int tm_year;        /* 自 1900 起的年数                */
   int tm_wday;        /* 一周中的第几天，范围从 0 到 6                */
   int tm_yday;        /* 一年中的第几天，范围从 0 到 365                    */
   int tm_isdst;       /* 夏令时                        */    
};

• 返回值
  该函数返回一个 C 字符串，包含了可读格式的日期和时间信息 Www Mmm dd hh:mm:ss yyyy，其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。

• 实例

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

int main(int argc, const char * argv[]) {
    struct tm t;
    t.tm_sec = 10;
    t.tm_min = 10;
    t.tm_hour = 6;
    t.tm_mday = 25;
    t.tm_mon = 2;
    t.tm_year = 118;
    t.tm_wday = 0;
 
    printf("%s ",asctime(&t));
    
    return 0;

    output:
    Sun Mar 25 06:10:10 2018
}

二、ctime()

• 描述
  C 库函数 char *ctime(const time_t *timer) 返回一个表示当地时间的字符串，当地时间是基于参数 timer。

返回的字符串格式如下： Www Mmm dd hh:mm:ss yyyy 其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。

• 声明

char *ctime(const time_t *timer)

• 实例

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

int main(int argc, const char * argv[]) {
    time_t currentTime;
    time(&currentTime);//获取当前时间
    char *cTime = ctime(&currentTime);//格式输出
    printf("%s ",cTime);
    
    return 0;
}

output:
Sun Dec 30 16:59:32 2018

三、gettimeofday()

• 描述
  gettimeofday()会把目前的时间有tv 所指的结构返回，当地时区的信息则放到tz 所指的结构中。

• 声明
  头文件：#include <sys/time.h> #include <unistd.h>

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

• 结构定义

timeval 结构定义为：
struct timeval{
    long tv_sec;  //秒
    long tv_usec;  //微秒
};

timezone 结构定义为：
struct timezone{
    int tz_minuteswest;/*格林威治时间往西方的时差*/
    int tz_dsttime;/*DST 时间的修正方式*/
};

tz_dsttime所代表的状态如下

    DST_NONE  //不使用
    DST_USA  //美国
    DST_AUST  //澳洲
    DST_WET  //西欧
    DST_MET  //中欧
    DST_EET  //东欧
    DST_CAN  //加拿大
    DST_GB  //大不列颠
    DST_RUM  //罗马尼亚
    DST_TUR  //土耳其
    DST_AUSTALT  //澳洲(1986 年以后)

• 实例

#include <stdio.h>
#include <sys/time.h>
#include <unistd.h>

int main(int argc, const char * argv[]) {
    struct timeval tv;
    struct timezone tz;
    gettimeofday(&tv, &tz);
    printf("tv_sec:%ld\n",tv.tv_sec);
    printf("tv_usec:%d\n",tv.tv_usec);
    printf("tz_minuteswest: %d\n", tz.tz_minuteswest);
    printf("tz_dsttime:%d\n", tz.tz_dsttime);
    
    return 0;
}

output:
tv_sec:1546161083
tv_usec:280261
tz_minuteswest: -480
tz_dsttime:0

四、gmtime()

• 描述
  C 库函数 struct tm *gmtime(const time_t *timer) 使用 timer 的值来填充 tm 结构，并用协调世界时（UTC）也被称为格林尼治标准时间（GMT）表示。
• 声明

struct tm *gmtime(const time_t *timer)

• 返回值

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 到 11                */
   int tm_year;        /* 自 1900 起的年数                */
   int tm_wday;        /* 一周中的第几天，范围从 0 到 6                */
   int tm_yday;        /* 一年中的第几天，范围从 0 到 365                    */
   int tm_isdst;       /* 夏令时                        */    
};

• 实例

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

#define BST (+1)
#define CCT (+8)

int main(int argc, const char * argv[]) {
    time_t rawtime;
    struct tm *info;
    
    time(&rawtime);
    /* 获取 GMT 时间 */
    info = gmtime(&rawtime );
    
    printf("当前的世界时钟：\n");
    printf("伦敦：%2d:%02d\n", (info->tm_hour+BST)%24, info->tm_min);
    printf("中国：%2d:%02d\n", (info->tm_hour+CCT)%24, info->tm_min);
    
    return(0);
}
output:
当前的世界时钟：
伦敦：10:18
中国：17:18

五、localtime()

• 描述
  C 库函数 struct tm *localtime(const time_t *timer) 使用 timer 的值来填充 tm 结构。timer 的值被分解为 tm 结构，并用本地时区表示。

• 声明

struct tm *localtime(const time_t *timer)

• 返回值
  同上面的四

• 实例

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

int main(int argc, const char * argv[]) {
    time_t c_time;
    struct tm *info;
    
    time(&c_time);
    
    info = localtime(&c_time);
    printf("本地时间日期: %s",asctime(info));
    
    return(0);
}
output:
本地时间日期: Sun Dec 30 17:27:32 2018

六、mktime()

• 描述
  C 库函数 time_t mktime(struct tm *timeptr) 把 timeptr 所指向的结构转换为一个依据本地时区的 time_t 值。

• 声明

time_t mktime(struct tm *timeptr)

• 实例

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

int main(int argc, const char * argv[]) {
    time_t rawtime;
    struct tm * timeinfo;
    int year, month ,day;
    const char * weekday[] = { "周日", "周一","周二", "周三","周四", "周五", "周六"};
    
    /* 用户输入日期 */
    printf ("年: "); fflush(stdout); scanf ("%d",&year);
    printf ("月: "); fflush(stdout); scanf ("%d",&month);
    printf ("日: "); fflush(stdout); scanf ("%d",&day);
    
    /* 获取当前时间信息，并修改用户输入的输入信息 */
    time ( &rawtime );
    timeinfo = localtime ( &rawtime );
    timeinfo->tm_year = year - 1900;
    timeinfo->tm_mon = month - 1;
    timeinfo->tm_mday = day;
    
    /* 调用 mktime: timeinfo->tm_wday  */
    mktime ( timeinfo );
    
    printf ("那一天是：%s\n", weekday[timeinfo->tm_wday]);
    
    return(0);
}
output:
年: 2018
月: 12
日: 30
那一天是：周日

七、time()

• 头文件、声明

#include <time.h>

time_t time(time_t *t);

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

• 实例

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

int main(int argc, const char * argv[]) {
    int seconds;
    time((time_t *)&seconds);
    printf("%d\n", seconds);
    return(0);
}

output:
1546162914