时间函数

函数

一、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

推荐阅读更多精彩内容