time库 总结

库变量struct tm

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;       /* 夏令时                */
};

库函数 time()

描述
C库函数 time_t time(time_t *seconds) 返回自纪元 Epoch（1970-01-01 00:00:00 UTC）起经过的时间，以秒为单位。如果 seconds 不为空，则返回值也存储在变量 seconds 中。

声明
下面是 time() 函数的声明。

time_t time(time_t *seconds)

参数
seconds -- 这是指向类型为 time_t 的对象的指针，用来存储 seconds 的值。

返回值
以 time_t 对象返回当前日历时间。

实例

#include <stdio.h>
#include <time.h>
 
int main ()
{
  time_t seconds;
 
  seconds = time(NULL); // 等同 time(&seconds);
  printf("the elapsed seconds from 1970-01-01 = %ld\n", seconds);
  
  return(0);
}

结果：

the elapsed seconds from 1970-01-01 = 1628872228

库函数 localtime()

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

声明
下面是 localtime() 函数的声明。

struct tm *localtime(const time_t *timer)

参数
timer -- 这是指向表示日历时间的 time_t 值的指针。

返回值
该函数返回指向 tm 结构的指针，该结构带有被填充的时间信息。

实例

#include <stdio.h>
#include <time.h>
 
int main ()
{
   time_t rawtime;
   struct tm *info;
   char buffer[80];
 
   time( &rawtime );
 
   info = localtime( &rawtime );
   printf("datetime:\t%d-%d-%d %d:%d:%d\n",info->tm_year+1900, info->tm_mon+1, info->tm_mday, info->tm_hour, info->tm_min, info->tm_sec) ;
 
   return(0);
}

结果：

datetime: 2021-8-13 16:29:30

库函数 mktime()

描述
C 库函数 time_t mktime(struct tm *timeptr) 把 timeptr 所指向的结构转换为自 1970 年 1 月 1 日以来持续时间的秒数，发生错误时返回-1。
是localtime函数的反向函数。

声明
下面是 mktime() 函数的声明。

time_t mktime(struct tm *timeptr)

参数
timeptr -- 这是指向 tm 结构的指针，该结构带有被填充的时间信息。

返回值
该函数返回自 1970 年 1 月 1 日以来持续时间的秒数。如果发生错误，则返回 -1 值。

实例

#include <stdio.h>
#include <time.h>
 
int main ()
{
   time_t rawtime;
   struct tm *info;
   char buffer[80];
 
   time( &rawtime );
 
   info = localtime( &rawtime );
   printf("the elapsed seconds from 1970-01-01 = %ld\n", rawtime);
   printf("datetime:\t%d-%d-%d %d:%d:%d\n",info->tm_year+1900, info->tm_mon+1, info->tm_mday, info->tm_hour, info->tm_min, info->tm_sec) ;
   time_t rawtime_;
   rawtime_ = mktime(info);
   printf("the elapsed seconds from 1970-01-01 = %ld\n", rawtime_);
 
   return(0);
}

结果：

the elapsed seconds from 1970-01-01 = 1628945579
datetime: 2021-8-14 12:52:59
the elapsed seconds from 1970-01-01 = 1628945579

库函数 ctime()

描述
C 库函数 char *ctime(const time_t *timer) 返回一个表示当地时间的字符串，当地时间是基于参数 timer。
返回的字符串格式如下： Www Mmm dd hh:mm:ss yyyy 其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。

声明
下面是 ctime() 函数的声明。

char *ctime(const time_t *timer)

参数
timer -- 这是指向 time_t 对象的指针，该对象包含了一个日历时间。

返回值
该函数返回一个 C 字符串，该字符串包含了可读格式的日期和时间信息。

实例

#include <stdio.h>
#include <time.h>
 
int main ()
{
   time_t curtime;
 
   time(&curtime);
 
   printf("current time = %s", ctime(&curtime));
 
   return(0);
}

结果：

current time = Sat Aug 14 14:00:15 2021

库函数 strftime()

描述
C 库函数 size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) 根据 format 中定义的格式化规则，格式化结构 timeptr 表示的时间，并把它存储在 str 中。

声明
下面是 strftime() 函数的声明。

size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)

参数

• str -- 这是指向目标数组的指针，用来复制产生的 C 字符串。
• maxsize -- 这是被复制到 str 的最大字符数。
• format -- 这是 C 字符串，包含了普通字符和特殊格式说明符的任何组合。这些格式说明符由函数替换为表示 tm 中所指定时间的相对应值。格式说明符是：

说明符	替换为	实例
%a	缩写的星期几名称	Sun
%A	完整的星期几名称	Sunday
%b	缩写的月份名称	Mar
%B	完整的月份名称	March
%c	日期和时间表示法	Sun Aug 19 02:56:02 2012
%d	一月中的第几天（01-31）	19
%H	24 小时格式的小时（00-23）	14
%I	12 小时格式的小时（01-12）	05
%j	一年中的第几天（001-366）	231
%m	十进制数表示的月份（01-12）	08
%M	分（00-59）	55
%p	AM 或 PM 名称	PM
%S	秒（00-61）	02
%U	一年中的第几周，以第一个星期日作为第一周的第一天（00-53）	33
%w	十进制数表示的星期几，星期日表示为 0（0-6）	4
%W	一年中的第几周，以第一个星期一作为第一周的第一天（00-53）	34
%x	日期表示法	08/19/12
%X	时间表示法	02:50:06
%y	年份，最后两个数字（00-99）	01
%Y	年份	2012
%Z	时区的名称或缩写	CDT
%%	一个 % 符号	%

• timeptr -- 这是指向 tm 结构的指针.

返回值
如果产生的 C 字符串小于 maxsize 个字符（包括空结束字符），则会返回复制到 str 中的字符总数（不包括空结束字符），否则返回零。

实例

#include <stdio.h>
#include <time.h>
 
int main ()
{
   time_t rawtime;
   struct tm *info;
   char buffer[80];
 
   time( &rawtime );
 
   info = localtime( &rawtime );
 
   strftime(buffer, 80, "%Y-%m-%d %H:%M:%S", info);
   printf("datetime: %s\n", buffer );
  
   return(0);
}

结果：

datetime: 2021-08-14 14:34:15

库函数 strptime()

char *strptime(const char *buf, const char *format, struct tm *timeptr)

作用：
函数strptime是将一个字符串格式化为一个tm结构。在功能上与函数strftime正好相反

参数：

• buf为要修改的时间，一般为GPS时间
• Format为数据格式，与buf时间格式必须一致，要不然会有段错误

应用

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

int main() {
    time_t now;
    time(&now);
    printf("elapsed time (seconds): %ld\n", now);
    struct tm* timerptr;
    timerptr = localtime(&now);
    printf("datetime: %d-%d-%d\n", timerptr->tm_year+1900, timerptr->tm_mon+1, timerptr->tm_mday);
    printf("calender: %s\n", ctime(&now));
    char buffer[64];
    strftime(buffer, 64, "%m-%d-%Y %H:%M:%S", timerptr);
    printf("calender: %s\n", buffer);
    time_t now_;
    now_ = mktime(timerptr);
    printf("elapsed time (seconds): %ld\n", now_);
    struct tm* timerptr_;
    strptime(buffer, "%m-%d-%Y %H:%M:%S", timerptr_);
    printf("datetime: %d-%d-%d\n", timerptr_->tm_year+1900, timerptr_->tm_mon+1, timerptr_->tm_mday);
}

结果:

elapsed time (seconds): 1628951771
datetime: 2021-8-14
calender: Sat Aug 14 14:36:11 2021

calender: 08-14-2021 14:36:11
elapsed time (seconds): 1628951771
datetime: 2021-8-14