C语言 | 时间日期函数

最新推荐文章于 2021-09-22 11:09:11 发布

嵌入式大杂烩

最新推荐文章于 2021-09-22 11:09:11 发布

阅读量3.1k

点赞数 1

分类专栏： C/C++

本文链接：https://blog.csdn.net/zhengnianli/article/details/106684184

版权

C/C++ 专栏收录该内容

125 篇文章 147 订阅

订阅专栏

1024G 嵌入式资源大放送！包括但不限于C/C++、单片机、Linux等。关注微信公众号【嵌入式大杂烩】，回复1024，即可免费获取！

前言

time.h是C/C++中的日期和时间头文件。用于需要时间方面的函数。下面分享time.h头文件中几个常用函数的用法：

time()函数

函数原型

time_t time(time_t *t);

函数说明

time_t 是long int 类型。此函数会返回从公元1970年1月1日的UTC时间从0时0 分0秒算起到现在所经过的秒数。如果t是空指针，直接返回当前时间。如果t不是空指针，返回当前时间的同时，将返回值赋予t指向的内存空间。

函数返回值

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

示例程序

#include <stdio.h>
#include <time.h>
int main(void)
{
    time_t sec = time((time_t*)NULL);
    printf("1970-01-01至现在的秒数为：%d\n", sec);
  
   return 0;
}

输出结果

1970-01-01至现在的秒数为：1542377079

gmtime()函数

函数原型

struct tm *gmtime(const time_t *timep);

函数说明

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

结构tm的定义为：

struct tm{
    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;  //日光节约时间的旗标
};

函数返回值

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

示例程序

#include <stdio.h>
#include <time.h>
int main(void)
{
    char *wday[] = {"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"};
    time_t t;
    struct tm *p;
    int year = 0, mon = 0, mday = 0;
    int hour = 0, min = 0, sec = 0;
    char *week = NULL;

    time(&t);
    p = gmtime(&t);
    year = 1900 + p->tm_year;
    mon = 1 + p->tm_mon;
    mday = p->tm_mday;
    week = wday[p->tm_wday];
    hour = 8 + p->tm_hour; //获取当地时间，与UTC时间相差8小时   
    min = p->tm_min;
    sec = p->tm_sec;
    printf("%d-%d-%d %s", year, mon, mday, week);
    printf(" %.2d:%.2d:%.2d\n", hour, min, sec);
  
    return 0;
}

输出结果

2018-11-16 Fri 22:23:25

localtime()函数

函数原型

struct tm *localtime(const time_t * timep);

函数说明

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

函数返回值

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

示例程序

#include <stdio.h>
#include <time.h>
int main(void)
{
    char *wday[] = {"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"};
    time_t t;
    struct tm *p;
   int year = 0, mon = 0, mday = 0;
   int hour = 0, min = 0, sec = 0;
   char *week = NULL;
  
    time(&t);
    p = localtime(&t); //取得当地时间
   year = 1900 + p->tm_year;
   mon = 1 + p->tm_mon;
   mday = p->tm_mday;
   week = wday[p->tm_wday];
   hour = p->tm_hour;
   min = p->tm_min;
   sec = p->tm_sec;
  
    printf("%d-%d-%d %s", year, mon, mday, week);
    printf(" %.2d:%.2d:%.2d\n", hour, min, sec);
  
   return 0;
}

输出结果

2018-11-16 Fri 22:32:27

ctime()函数

函数原型

char *ctime(const time_t *timep);

函数说明

ctime()将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回。此函数已经由时区转换成当地时间。注意：若再调用相关的时间日期函数，此字符串可能会被破坏。

函数返回值

返回一字符串表示目前当地的时间日期。格式：星期,月,日,小时:分:秒,年。

示例程序

#include <stdio.h>
#include <time.h>
int main(void)
{
    time_t t;
    time(&t);
    printf("%s\n", ctime(&t));
  
   return 0;
}

输出结果

Fri Nov 16 22:38:51 2018

asctime()函数

函数原型

char *asctime(const struct tm * timeptr);

函数说明

asctime()将参数timeptr所指的tm结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回。此函数已经由时区转换成当地时间。注意：若再调用相关的时间日期函数，此字符串可能会被破坏。与ctime()函数的不同在于传入参数结构不同。

函数返回值

返回一字符串表示目前当地的时间日期。格式：星期,月,日,小时:分:秒,年。

示例程序

#include <stdio.h>
#include <time.h>
int main(void)
{
    time_t t;
   struct tm *p;
   char *date = NULL;
  
    time(&t);
   p = gmtime(&t);
   date = asctime(p);
  
    printf("%s\n", date);
  
   return 0;
}

输出结果